Table Of Contents

show ethernet cfm maintenance-points local

show ethernet cfm maintenance-points remote

show ethernet cfm maintenance-points remote crosscheck

show ethernet cfm maintenance-points remote detail

show ethernet cfm mpdb

show ethernet cfm pm

show ethernet cfm smep

show ethernet cfm statistics

show ethernet cfm traceroute-cache

show ethernet lmi

show ethernet mac-tunnel engine slot

show ethernet oam debug link-monitor

show ethernet oam discovery

show ethernet oam runtime

show ethernet oam statistics

show ethernet oam status

show ethernet oam summary

show ethernet service evc

show ethernet service instance

show ethernet service interface

show ethernet service mac-tunnel

show lacp

show lldp

show nmsp

show ptp clock dataset

show ptp clock dataset parent

show ptp clock dataset time-properties

show ptp clock running

show ptp port dataset foreign-master

show ptp port dataset port

shutdown (bridge-domain)

snmp-server enable traps ethernet cfm alarm

snmp-server enable traps ethernet cfm cc

snmp-server enable traps ethernet cfm crosscheck

snmp-server enable traps ethernet evc

snmp-server enable traps ether-oam

snmp-server host traps evc

source template (eoam)

status decoupled

status peer topology dual-homed

sync interval

template (eoam)

tod

traceroute ethernet

traceroute ethernet evc

traceroute ethernet vlan

transport ipv4 (PTP)

uni count

weight (srvs instance)

show ethernet cfm maintenance-points local

To display information about maintenance points configured on a device, use the show ethernet cfm maintenance-points local command in privileged EXEC mode.

show ethernet cfm maintenance-points local [detail] [mep | mip] [domain domain-name | interface type number | level level-id | evc evc-name]

Syntax Description

detail	(Optional) Indicates that detailed output is specified.
mep	(Optional) Indicates that a maintenance endpoint (MEP) is specified.
mip	(Optional) Indicates that a maintenance intermediate point (MIP) is specified.
domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
interface	(Optional) Indicates that an interface is specified.
type number	(Optional) Type and number of the interface.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
evc	(Optional) Indicates that an Ethernet virtual circuit (EVC) is specified.
evc-name	(Optional) Identifier of the EVC.

Command Default

When none of the optional keywords and arguments are specified, information about all the maintenance points on the device is shown.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	The detail and evc keywords and the evc-name argument were added.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2. •The evc keyword and evc-name argument are not supported in this release.
15.0(1)XA	This command was modified. The evc keyword and evc-name argument are not supported in this release.

Usage Guidelines

The show ethernet cfm maintenance-points local command allows you to filter output. You can display information about maintenance points as follows:

•Independent of domain or interface

•On a particular interface independent of domain

•On a particular interface belonging to a given domain

•Belonging to a given domain independent of interface

The display may also be restricted to either MEPs or MIPs.

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

Examples

Following is sample output from a show ethernet cfm maintenance-points local detail command when none of the other optional keywords and arguments are specified:

Router# show ethernet cfm maintenance-points local detail 

Local MEPs:

--------------------------------------------------------------------------------

MPID Domain Name                                 Lvl   MacAddress     Type  CC  

     Domain Id                                   Dir   Port           Id        

     MA Name                                           SrvcInst                 

     EVC name                                                                   

--------------------------------------------------------------------------------

301  Domain_L7                                   7     aabb.cc03.bb99 Vlan  Y

     Domain_L7                                   Up    Et0/1          11   

     cust_700_l7                                       N/A

     N/A                                                       

401  Domain_L5                                   5     aabb.cc03.bb99 Vlan  Y

     Domain_L5                                   Up    Et0/1          9    

     cust_500_l5                                       N/A

     N/A                                                       

Total Local MEPs: 2

Local MIPs: None

Table 8 describes the significant fields shown in the display.

Table 8 show ethernet cfm maintenance-points local Field Descriptions 

Field	Description
MPID	Identifier of the maintenance point.
Domain Name	Name of the domain.
Lvl	Maintenance level where the maintenance point is configured.
MacAddress	MAC address of the maintenance point.
Type	Type of MEP (VLAN or port MEP)
CC	Continuity check operational status.
Domain Id	Identifier of the domain.
Dir	Direction which the maintenance point is facing.
Port	Port MEP.
Id	Identifier of the VLAN.
MA Name	Name of the maintenance association.
SrvcInst	MAC address of the MEP.
EVC name	Name of the Ethernet virtual circuit (EVC).

show ethernet cfm maintenance-points remote

To display detailed information about remote maintenance endpoints (MEPs) configured statically in the MEP list and their status in the continuity check database (CCDB), use the show ethernet cfm maintenance-points remote command in privileged EXEC mode.

Cisco pre-Standard Ethernet Connectivity Fault Management Draft 1 (CFM D1)

show ethernet cfm maintenance-points remote [domain domain-name | level level-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm maintenance-points remote [domain domain-name | [[crosscheck | static] [domain domain-name | mpid mpid [domain domain-name]] [port | vlan vlan-id]]]

Syntax Description

domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
crosscheck	(Optional) Shows the Mep-Up status from the D1 crosscheck function.
static	(Optional) Shows the Mep-Up status from the continuity-check static rmep function.
mpid	(Optional) Shows a remote maintenance point.
mpid	(Optional) Integer from 0 to 8191 that identifies the maintenance point.
port	(Optional) Shows the operational state of the port MEP.
vlan	(Optional) Shows a VLAN configuration.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.

Command Default

When neither a domain nor a level (CFM D1 only) is specified, all CCDB MEP entries are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SRB	The output of this command was enhanced to include the port state values of REMOTE_EE, LOCAL_EE, and TEST.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

When no maintenance domain is specified, all entries are displayed; otherwise only entries belonging to the specified domain or level (CFM D1 only) are shown.

Examples

The following example shows output from a show ethernet cfm maintenance-points remote command:

Router# show ethernet cfm maintenance-points remote

--------------------------------------------------------------------------------

MPID  Domain Name                                 MacAddress          IfSt  PtSt

 Lvl  Domain ID                                   Ingress                       

 RDI  MA Name                                     Type Id             SrvcInst  

      EVC Name                                                        Age       

--------------------------------------------------------------------------------

37    Domain_port                                 aabb.cc03.ba00      Up    N/A 

 0    Domain_port                                 Et0/0                         

 -    portmep                                     Port none           N/A       

      N/A                                                             1s

401   Domain_L5                                   aabb.cc03.bb99      Up    Up  

 5    Domain_L5                                   Et0/0.9                       

 -    cust_500_l5                                 Vlan 9              N/A       

      N/A                                                             2s

301   Domain_L7                                   aabb.cc03.bb99      Up    Up  

 7    Domain_L7                                   Et0/0.11                      

 -    cust_700_l7                                 Vlan 11             N/A       

      N/A                                                             0s

Total Remote MEPs: 3

Table 9 describes the significant fields shown in the display.

Table 9 show ethernet cfm maintenance-points remote Field Descriptions 

Field	Description
MPID	Identifier of the MEP.
Lvl	Maintenance level.
RDI	Remote defect indication (RDI) messages on the maintenance point.
Domain Name	Name of the domain.
Domain ID	MAC address of the MEP.
MA Name	Name of the maintenance association.
EVC Name	Identifier of the Ethernet virtual circuit (EVC).
Mac Address	MAC address of the MEP.
Ingress	Port on which the packet is received.
Type Id	Type of service.
IfSt	Operational state of the interface.
SrvcInst	MAC address of the MEP.
Age	Amount of time, in seconds, the entry has been in the database.
PtSt	Operational state of the port MEP. Values are: UP—Operational. DOWN—Not operational. ADMINDOWN—Administratively down. REMOTE_EE—Encountered excessive remote errors. LOCAL_EE—Encountered excessive local errors. TEST—Test state.

Related Commands

Command	Description
show ethernet cfm maintenance-points local	Displays information about maintenance points configured on a device.
show ethernet cfm maintenance-points remote crosscheck	Displays information about remote maintenance points configured statically in a cross-check list.
show ethernet cfm maintenance-points remote detail	Displays information about a remote maintenance point in the continuity check database.

show ethernet cfm maintenance-points remote crosscheck

To display information about remote maintenance points configured statically in a cross-check list, use the show ethernet cfm maintenance-points remote crosscheck command in privileged EXEC mode.

Cisco pre-Standard Connectivity Fault Management Draft 1 (CFM D1)

show ethernet cfm maintenance-points remote crosscheck [mpid id | mac mac-address] [domain domain-name | level level-id] [evc evc-name | vlan vlan-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm maintenance-points remote crosscheck [domain domain-name | mpid id [domain domain-name]] [evc evc-name | port | vlan vlan-id]

Syntax Description

mpid	(Optional) Indicates that a maintenance domain is specified.
id	(Optional) Integer from 0 to 8191 that identifies the maintenance domain.
mac	(Optional) Indicates that a maintenance domain is specified.
mac-address	(Optional) MAC address of the remote maintenance point, in the format abcd.abcd.abcd.
domain	(Optional) Indicates that a maintenance domain is specified.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Indicates that a maintenance level is specified.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
evc	(Optional) Indicates an Ethernet virtual circuit (EVC) is specified. An EVC is an association of two or more user network interfaces (UNIs).
evc-name	(Optional) String that identifies the EVC.
port	(Optional) Indicates DOWN service direction with no VLAN association.
vlan	(Optional) Indicates a VLAN for configuration.
vlan-id	(Optional) Integer value of 1 to 4094 that identifies the VLAN.

Command Default

When no options are specified, maintenance point IDs (MPIDs), MAC addresses, domains, levels, and VLANs for all maintenance points on the list are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	The evc keyword and evc-name argument were added on the Cisco 7600 Series Route Switch Processor 720 (RSP 720) and the Cisco 7600 Series Supervisor Engine 720.
12.2(33)SRE	This command was modified. Support for the port keyword was added in Cisco IOS Release 12.2(33)SRE.

Examples

Following is sample output from a show ethernet cfm maintenance-points remote crosscheck command for maintenance points at maintenance level 4:

Router# show ethernet cfm maintenance-points remote crosscheck level 4

-------------------------------------------------------------------------------

MPID Level VLAN Mep-Up Remote Mac                                              

-------------------------------------------------------------------------------

200  4     0    No     aabb.cc00.0310

-------------------------------------------------------------------------------

MPID Level Mep-Up Remote Mac                                                   

           EVC                                                                 

-------------------------------------------------------------------------------

200  4     No     aabb.cc00.0310

           evc_100

Table 10 describes the significant fields shown in the display.

Table 10 show ethernet cfm maintenance-points remote crosscheck Field Descriptions 

Field	Description
MPID	Identifier of the maintenance point.
Level	Maintenance level where the maintenance point is configured.
VLAN	ID of the VLAN on which the maintenance point is configured.
Mep-Up	Operational status of the MEP.
Remote Mac	MAC address of the remote maintenance point.
EVC	ID of the EVC on which the maintenance point is configured.

Related Commands

Command	Description
show ethernet cfm maintenance-points local	Displays information about maintenance points configured on a device.
show ethernet cfm maintenance-points remote	Displays information about remote maintenance points in the continuity check database.
show ethernet cfm maintenance-points remote detail	Displays information about a remote maintenance point in the continuity check database.

show ethernet cfm maintenance-points remote detail

To display information about a remote maintenance point in the continuity check database, use the show ethernet cfm maintenance-points remote detail command in privileged EXEC mode.

Cisco pre-Standard Connectivity Fault Management Draft 1 (CFM D1)

show ethernet cfm maintenance-points remote detail {mac mac-address | mpid id} [domain domain-name | level level-id] [evc evc-name | service service-name | vlan vlan-id]

CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm maintenance-points remote detail {mac mac-address | mpid id} [domain domain-name | evc evc-name | port | vlan vlan-id]]

Syntax Description

mac	Shows a remote MAC address.
mac-address	MAC address of the remote maintenance point, in the format abcd.abcd.abcd.
mpid	Shows a remote maintenance point.
id	Integer from 0 to 8191 that identifies the maintenance point.
domain	(Optional) Shows a specific maintenance domain.
domain-name	(Optional) String of a maximum of 154 characters.
level	(Optional) Shows a specific maintenance level.
level-id	(Optional) Integer from 0 to 7 that identifies the maintenance level.
evc	(Optional) Shows an Ethernet virtual circuit (EVC). An EVC is an association of two or more user network interfaces (UNIs).
evc-name	(Optional) String that identifies the EVC name.
service	(Optional) Shows a customer service instance.
service-name	(Optional) String that identifies the service instance.
port	(Optional) Shows the operational state of the port MEP.
vlan	(Optional) Shows a VLAN configuration.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.

Command Default

When no options are specified, all remote maintenance endpoints (MEPs) matching the specified MAC address or maintenance point ID (MPID) are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRD	Output was modified in Cisco IOS Release 12.2(33)SRD to show detailed information about Receive RDI and EVC. The evc keyword and evc-name argument were also introduced.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.
15.0(1)XA	This command was modified. Support for the evc keyword and evc-name argument was added in Cisco IOS Release 15.0(1)XA.

Usage Guidelines

Use this command to obtain information about a specific maintenance point by specifying its MPID or to obtain information about all maintenance points that have a particular MAC address.

When a maintenance domain is not specified, all matching maintenance points, independent of their levels (CFM D1 only), are displayed; otherwise, only maintenance points at the specified maintenance domain are shown.

In CFM D1 only, when an EVC is specified, only maintenance points that are members of the EVC are displayed.

When a VLAN is specified, only maintenance points on that VLAN are displayed.

Examples

The following is sample output from a show ethernet cfm maintenance-points remote detail command using the mpid option:

Router# show ethernet cfm maintenance-points remote detail mpid 401

Version: IEEE-CFM

MAC Address: aabb.cc03.bb99

Domain Name: Domain_L5

MA Name: cust_500_l5

Level: 5

VLAN: 9

MPID: 401

Sender Chassis ID: Router3-cfm

Incoming Port(s): Ethernet0/0.9

CC Lifetime(sec): 35

Age of Last CC Message(sec): 10

CC Packet Statistics: 91/0 (Received/Error)

MEP interface status: Up

MEP port status: Up

Receive RDI: FALSE

Router#

Table 11 describes the significant fields shown in the display.

Table 11 show ethernet cfm maintenance-points remote detail Field Descriptions 

Field	Description
Version	Version of CFM that is running.
MAC Address	MAC address of the remote MEP
Domain Name	Name of the domain.
MA Name	Name of the maintenance association.
Level	Maintenance domain level.
VLAN	Configured VLAN.
MPID	Identifier of the maintenance point.
Sender Chassis ID	Name of the other switch or router when sender-id is configured on that device.
Incoming Port(s)	Identifier of the port that receives the message.
CC Lifetime(sec)	Amount of time, in seconds, that the message should remain in the database before being purged.
Age of Last CC Message(sec)	Amount of time, in seconds, the previous continuity check message (CCM) has been in the database.
CC Packet Statistics	Number of packets received and number of packets with errors.
MEP interface status	Operational state of the MEP interface.
MEP port status	Operational state of the MEP port.
Receive RDI	Receive status of remote defect indication (RDI) messages on the maintenance point.

Related Commands

Command	Description
show ethernet cfm maintenance-points local	Displays information about maintenance points configured on a device.
show ethernet cfm maintenance-points remote	Displays information about remote maintenance points in the continuity check database.
show ethernet cfm maintenance-points remote crosscheck	Displays information about remote maintenance points configured statically in a cross-check list.

show ethernet cfm mpdb

To display the contents of a maintenance intermediate point (MIP) continuity check database (CCDB), use the show ethernet cfm mpdb command in privileged EXEC mode.

show ethernet cfm mpdb [domain-id {mac-address domain-number | domain-name | dns dns-name | null}] [service {ma-name | ma-num | vlan-id vlan-id | vpn-id vpn-id}]

Syntax Description

domain-id	(Optional) Displays by domain ID.
mac-address	(Optional) MAC address of the maintenance domain.
domain-number	(Optional) Integer from 0 to 65535.
domain-name	(Optional) String of a maximum of 43 characters.
dns	(Optional) Specifies a domain name service (DNS).
dns-name	(Optional) String of a maximum of 43 characters.
null	(Optional) Indicates there is not a domain name.
service	(Optional) Specifies a maintenance association within the domain.
ma-name	(Optional) String that identifies the maintenance association.
ma-num	(Optional) Integer that identifies the maintenance association.
vlan-id	(Optional) Specifies a VLAN.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.
vpn-id	(Optional) Specifies a virtual private network (VPN).
vpn-id	(Optional) Integer from 1 to 32767 that identifies the VPN.

Command Default

When no maintenance domain is specified, all entries are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was integrated into Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

Use this command to display cataloged information received from MEPs.

Examples

The following example shows sample output from a show ethernet cfm mpdb command:

Router# show ethernet cfm mpdb 

* = Can Ping/Traceroute to MEP

--------------------------------------------------------------------------------

MPID  Domain Name                                 MacAddress          Version   

Lvl   Domain ID                                   Ingress                       

Expd  MA Name                                     Type Id             SrvcInst  

      EVC Name                                                        Age       

--------------------------------------------------------------------------------

220 * Domain_L5                                   aabb.cc03.b999      IEEE-CFM 

5     Domain_L5                                   Et0/0.1       

EXPD  cust_500_l5                                 Vlan 9              N/A       

      N/A                                                             87s

101 * Domain_L7                                   aabb.cc03.b999      IEEE-CFM 

7     Domain_L7                                   Et0/0.11      

-     cust_700_l7                                 Vlan 11             N/A       

      N/A                                                             1s

Total Remote MEPs: 2

Table 12 describes the significant fields shown in the display.

Table 12 show ethernet cfm mpdb Field Descriptions 

Field	Description
MPID	Maintenance endpoint ID.
Domain Name	Maintenance domain name.
MacAddress	MAC address of the remote MEP.
Version	Version of the CFM protocol that is running.
Lvl	Maintenance domain level.
Domain ID	Maintenance domain identifier.
Ingress	Interface receiving connectivity fault management traffic.
Expd	Lifetime timer has expired.
MA Name	Name of the maintenance association.
Type Id	Identifies a port MEP, VLAN, or Bridge Domain (BD). "None" indicates an untagged port MEP and a number indicates a VLAN or BD.
SrvcInst	Service instance
EVC Name	Identifier of the Ethernet virtual circuit (EVC).
Age	Age of message in the MIP CCDB.

show ethernet cfm pm

To display detailed information about Ethernet connectivity fault management (CFM) performance monitoring, use the show ethernet cfm pm command in privileged EXEC mode.

show ethernet cfm pm [session {session-id | active | detail {session-id | all} | inactive | summary}]

Syntax Description

session	(Optional) Displays a performance monitoring session.
session-id	(Optional) Integer from 0 to 8000 that identifies the session.
active	(Optional) Displays all active sessions.
detail	(Optional) Displays detailed information about the session.
all	(Optional) Displays detailed information about all sessions.
inactive	(Optional) Displays all inactive sessions.
summary	(Optional) Displays a summary of the current sessions.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.1(2)S	This command was introduced.

Usage Guidelines

Use this command to view the CFM performance monitoring activities in your network.

Examples

The following example shows output from a show ethernet cfm pm command:

Router# show ethernet cfm pm

----------------------------------------------------------------------------

EPM-ID   SLA-ID    Lvl/Type/ID/Cos/Dir Src-Mac-address Dst-Mac-address      

----------------------------------------------------------------------------

 0        3         4/BD-V/10/1/Down    2db.4980.0400  02db.4980.0200

The following example shows output from a show ethernet cfm pm command using the session and summary keywords:

Router# show ethernet cfm pm session summary

Number of Configured Session : 2

Number of Active Session: 1

Number of Inactive Session: 1

Table 13 describes the significant fields shown in each display.

Table 13 show ethernet cfm pm Field Descriptions 

Field	Description
EPM-ID	Internal ID of the Ethernet performance monitoring session.
SLA-ID	IP SLA instance ID.
Lvl	Maintenance domain level (0 to 7).
Type	Name of the domain.
Cos	Class of service.
Direction	Direction of the MEP, either down or up.
Src-Mac-address	MAC address of the source device.
Dst-Mac-address	MAC address of the destination device.
Number of Configured Session	Number of configured performance monitoring sessions.
Number of Active Session	Number of performance monitoring sessions in the active state.
Number of Inactive Session	Number of performance monitoring sessions in the inactive state.

show ethernet cfm smep

To display connectivity fault management (CFM) system maintenance end point (SMEP) settings on a device, use the show ethernet cfm smep command in privileged EXEC mode.

Ethernet Connectivity Fault Management (CFM) Cisco Proprietary Draft 1 (CFM D1)

show ethernet cfm smep [interface gigabitethernet number]

Ethernet CFM IEEE 802.1ag Standard (CFM IEEE)

show ethernet cfm smep [interface {gigabitethernet number | port-channel number}]

Syntax Description

interface	(Optional) Displays information about an interface.
gigabitethernet	(Optional) Displays information about a Gigabit Ethernet interface.
number	(Optional) •Integer from 1 to 6 that identifies a Gigabit Ethernet interface. •Integer from 1 to 564 that identifies a port channel.
port-channel	(Optional) Displays information about a configured port channel.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.
15.0(1)XA	This command was modified. Support for the port channel keyword was introduced in Cisco IOS Release 15.0(1)XA.

Usage Guidelines

This command allows filtering on a per-interface basis.

Alarm Indication Signal (AIS) messages are sent by default at the configured maintenance intermediate point (MIP) level if an AIS level is not configured.

Examples

The following example shows sample output from the show ethernet cfm smep command:

Router# show ethernet cfm smep

SMEP Settings:

--------------

Interface: GigabitEthernet1/1

LCK-Status: CFM Disabled

LCK Period: 60000 (ms)

Level to transmit LCK: Default

AIS-Status: CFM Disabled

AIS Period: 60000 (ms)

Level to transmit AIS: Default

Defect Condition: No Defect

Table 14 describes the significant fields shown in the display.

Table 14 show ethernet cfm smep Field Descriptions 

Field	Description
Interface	Specifies the interface type.
LCK-Status	Locked Signal function (LCK) sending status of the interface.
LCK Period	LCK transmission period on the interface.
Level to transmit LCK	Displays the level at which LCK frames are transmitted.
AIS-Status	AIS sending status of the interface.
AIS Period	AIS transmission period on the interface.
Level to transmit AIS	Displays the level at which AIS frames are transmitted.
Defect Condition	Displays the defect condition detected on the interface.

show ethernet cfm statistics

To display Ethernet connectivity fault management (CFM) information, use the show ethernet cfm statistics command in privileged EXEC mode.

show ethernet cfm statistics [domain [domain-name [service {ma-name | ma-num | vlan-id vlan-id | vpn-id vpn-id}]] | mpid mpid]

Syntax Description

domain	(Optional) Configures a maintenance domain.
domain-name	(Optional) String of a maximum of 154 characters.
service	(Optional) Configures a maintenance association within the domain.
ma-name	(Optional) String that identifies the maintenance association.
ma-num	(Optional) Integer that identifies the maintenance association.
vlan-id	(Optional) Configures a VLAN.
vlan-id	(Optional) Integer from 1 to 4094 that identifies the VLAN.
vpn-id	(Optional) Configures a virtual private network (VPN).
vpn-id	(Optional) Integer from 1 to 32767 that identifies the VPN.
mpid	(Optional) Configures a maintenance point identifier.
mpid	(Optional) Integer from 1 to 8191 that identifies the maintenance point.

Command Default

All domains are displayed when none of the keywords or arguments are selected.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was integrated into Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

Use this command to display an overview of transmitted and received messages.

If a domain name has more than 43 characters, a warning message is displayed notifying that the maintenance domain ID (MDID) will be truncated to 43 characters in continuity check messages (CCMs) if "id <fmt> <MDID>" is not configured.

Examples

Following is sample output from a show ethernet cfm statistics command:

Router# show ethernet cfm statistics 

BRAIN MAC: aabb.cc03.b999

DomainName: Domain_L7

MA Name: cust_700_l7

MPID: 101

  Last clearing of counters:  never

  CCMs:

    Transmitted:                242   Rcvd Seq Errors:        0

  LTRs:

    Unexpected Rcvd:              0

  LBRs:

    Transmitted:                  0   Rcvd Seq Errors:        0

    Rcvd in order:                0   Rcvd Bad MSDU:          0

DomainName: Domain_L5

MA Name: cust_500_l5

MPID: 220

  Last clearing of counters:  never

  CCMs:

    Transmitted:                202   Rcvd Seq Errors:        0

  LTRs:

    Unexpected Rcvd:              0

  LBRs:

    Transmitted:                  0   Rcvd Seq Errors:        0

    Rcvd in order:               10   Rcvd Bad MSDU:          0

DomainName: Domain_port

MA Name: portmep

MPID: 112

  Last clearing of counters:  never

  CCMs:

    Transmitted:                278   Rcvd Seq Errors:        0

  LTRs:

    Unexpected Rcvd:              0

  LBRs:

    Transmitted:                  0   Rcvd Seq Errors:        0

    Rcvd in order:                0   Rcvd Bad MSDU:          0

Table 15 describes the significant fields shown in the display.

Table 15 show ethernet cfm statistics Field Descriptions 

Field	Description
BRAIN MAC	Bridge brain MAC address.
DomainName	Domain name.
MA Name	Maintenance association name.
MPID	Maintenance point identifier.
CCMs	Continuity check messages transmitted.
LTRs	Linktrace responses.
LBRs	Loopback responses.

show ethernet cfm traceroute-cache

To display the contents of the traceroute cache, use the show ethernet cfm traceroute-cache command in privileged EXEC mode.

show ethernet cfm traceroute-cache

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

Use the show ethernet cfm traceroute-cache command to display the contents of the traceroute cache; for example, to see the maintenance intermediate points (MIPs) and maintenance endpoints (MEPs) of a domain as they were discovered. The data is historic. The traceroute cache stores entries from previous traceroute operations.

Examples

The following example shows output from a show ethernet cfm traceroute-cache command:

Router# show ethernet cfm traceroute-cache

Traceroute to aabb.cc03.b999 on Domain Domain_L5, Level 5, vlan 9 issued at 01:25:22

path found via MPDB

B = Intermediary Bridge

! = Target Destination

* = Per hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingr Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egr Action   Previous Hop    

--------------------------------------------------------------------------------

! 1                    aabb.cc03.b999                           RlyHit:MEP     

                       Not Forwarded                            aabb.cc03.bb99

Table 16 describes the significant fields shown in the display.

Table 16 show ethernet cfm traceroute-cache Field Descriptions 

Field	Description
Hops	Number of hops of the traceroute.
Host	Name of the device.
MAC	Bridge Brain MAC address of the device.
Ingress	Receiving port.
Ingr Action	Action on the ingress port: IngOk, IngFilter, IngBlocked.
Relay Action	Type of relay action performed: RlyNone, RlyUnknown, RlyFDB, RlyCCDB, RlyFiltered.
Forwarded	Traceroute forwarded or not forwarded.
Egress	Sending port.
Egr Action	Action on the egress port: EgrNone, EgrTTL, EgrDown, EgrBlocked, EgrOk, EgrGVRP, EgrDomainBoundary, EgrFiltered.
Previous Hop	MAC address of the neighboring device.

Related Commands

Command	Description
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
traceroute ethernet	Sends Ethernet CFM traceroute messages to a destination MAC address.

show ethernet lmi

To display Ethernet local management interface (LMI) Ethernet virtual connections (EVCs) configured on a device, use the show ethernet lmi command in privileged EXEC mode.

show ethernet lmi {{evc [detail evc-id [interface type number] | map interface type number]} | {parameters | statistics} interface type number | uni map [interface type number]}

Syntax Description

evc	Displays information about an EVC.
detail	(Optional) Displays detailed information about a specified EVC.
evc-id	(Optional) String of a maximum of 100 characters that identifies an EVC.
interface	Indicates that an interface is specified. This keyword is optional except with the parameters and statistics keywords.
type	String that identifies the type of interface. Valid options are the following: •ethernet—Ethernet IEEE 802.3 interface •fastethernet—Fast Ethernet IEEE 802.3 interface •gigabitethernet—Gigabit Ethernet IEEE 802.3z interface
number	Integer that identifies the interface.
map	(Optional) Indicates a VLAN map.
parameters	Displays Ethernet LMI parameters.
statistics	Displays Ethernet LMI statistics.
uni map	Displays information about the user-network interface (UNI).

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.4(9)T	This command was introduced.
12.2(33)SRB	Support for this command on the Cisco 7600 router was integrated into Cisco  IOS Release 12.2(33)SRB.

Usage Guidelines

Use this command to check the operational statuses of EVCs.

Examples

The following examples show output from a show ethernet lmi command for interface Ethernet 0/0 using different keywords and arguments.

The following sample output is generated from the show ethernet lmi command using the evc keyword:

Router# show ethernet lmi evc

St  EVC Id                                                       Port          

--- ------------------------------------------------------------ --------------

 A  EVC_MP2MP_101                                                Gi0/1         

 A  EVC_P2P_110                                                  Gi0/1         

Key: St=Status, A=Active, P=Partially Active, I=Inactive, ?=Link Down

The following sample output is generated from the show ethernet lmi command using the evc and optional detail keywords:

Router# show ethernet lmi evc detail EVC_MP2MP_101 

EVC Id: EVC_MP2MP_101

interface Ethernet0/0

  Time since Last Full Report: 00:25:25 

  Ether LMI Link Status: Up

  UNI Status: Up

  UNI Id: router3-e0/0+router-e0/0

  CE-VLAN/EVC Map Type: Bundling

  VLAN: 101

  EVC Status: Active

  EVC Type: Multipoint-to-Multipoint

  Remote UNI Count: Configured = 2, Active = 2

  UNI Id                                   UNI Status    Port

  ------                                   ----------    ----

  router4-e0/0+router1-e0/0                Up            Remote

  router5-e0/0+router6-e0/0                Up            Remote

Table 17 describes the significant fields shown in output of the show ethernet lmi command using the evc and detail keywords.

Table 17 show ethernet lmi evc detail Field Descriptions  

Field	Description
EVC Id	Identifier of the EVC.
Time since Last Full Report	Number of hours, minutes, seconds since the CE requested a detailed report.
Ether LMI Link Status	Operational state of the LMI link.
UNI Status	Operational state of the UNI.
UNI Id	Identifier of the UNI between the CE and PE devices.
CE-VLAN/EVC Map Type	EVC map type: bundling, multiplex, or all-to-one
VLAN	Identifier of the VLAN.
EVC Status	Operational state of the EVC.
EVC Type	Type of connection (point-to-point or multipoint-to-multipoint).
Remote UNI Count	Number of remote UNIs that are configured and the number that are operational.
Port	Type of port, either local or remote, on which the EVC is configured. If the port is local, the interface ID is specified.

The following sample output is generated from the show ethernet lmi command using the map interface keyword:

Router# show ethernet lmi evc map interface Ethernet0/0

UNI Id: router3-e0/0+router-e0/0

St  Evc Id                                   CE-VLAN                           

--- ---------------------------------------- ----------------------------------

  A EVC_MP2MP_101                            101                               

  A EVC_P2P_110                              110                               

Key: St=Status, A=Active, P=Partially Active, I=Inactive, *=Default EVC,

      ?=Link Down

Table 18 describes the significant fields shown in output of the show ethernet lmi command using the evc and map keywords.

Table 18 show ethernet lmi evc map Field Descriptions

Field	Description
UNI Id	Identifier of the UNI between the CE and PE devices.
St	Operational state of the EVC.
Evc Id	Identifier of the EVC.
CE-VLAN	Identifier of the VLAN used by the CE.

The following sample output is generated from the show ethernet lmi command using the parameters and interface keywords:

Router# show ethernet lmi parameters interface Ethernet0/0

E-LMI Parameters for interface Ethernet0/0

 Version : MEF.16-0106

    Mode : CE

    T391 : 10    

    T392 : NA

    N391 : 360   

    N393 : 4 

Table 19 describes the significant fields shown in output of the show ethernet lmi command using the parameters keyword.

Table 19 show ethernet lmi parameters Field Descriptions

Field	Description
Version	Version number of the specification that E-LMI implementation is based on.
Mode	Customer equipment or the Metro Ethernet network.
T391	Polling timer.
T392	Polling verification timer.
N391	Polling counter.
N393	Event counter.

The following sample output is generated from the show ethernet lmi command using the statistics and interface keywords:

Router# show ethernet lmi statistics interface Ethernet0/0

E-LMI Statistics for interface Ethernet0/0

  Ether LMI Link Status: Up

  UNI Status: Up

  UNI Id: router3-e0/0+router-e0/0

  Reliability Errors:

    Status Timeouts                    0  Invalid Sequence Number           0

    Invalid Status Response            0  Unsolicited Status Received       0

  Protocol Errors:

    Invalid Protocol Version           0  Invalid EVC Reference Id          0

    Invalid Message Type               0  Out of Sequence IE                0

    Duplicated IE                      0  Mandatory IE Missing              0

    Invalid Mandatory IE               0  Invalid non-Mandatory IE          0

    Unrecognized IE                    0  Unexpected IE                     0

    Short Message                      0

  Last Full Status Enq Sent     00:50:35  Last Full Status Rcvd      00:50:35

  Last Status Check Sent        00:00:06  Last Status Check Rcvd     00:00:06

  Last clearing of counters     00:09:57

---

Note The UNI Id field displays only when it is available from the provider edge router.

---

Table 20 describes the significant fields shown in output of the show ethernet lmi command using the statistics keyword.

Table 20 show ethernet lmi statistics Field Descriptions  

Field	Description
E-LMI Statistics for interface <interface-id>
Ether LMI Link Status	Operational state of Ethernet LMI connectivity.
UNI Status	Operational state of the UNI.
UNI Id	Identifer of the UNI.
Reliability Errors
Status Timeouts	Number of times that a status request has been sent but not received.
Invalid Sequence Number	Number of times the sequence numbers of Ethernet LMI packets do not match the sequence numbers expected.
Invalid Status Response	Number of times a status response received was invalid and discarded.
Unsolicited Status Received	Number of times status was received that had not been requested.
Protocol Errors
Invalid Protocol Version	Number of times the protocol version in Ethernet LMI packets does not match what is supported.
Invalid EVC Reference Id	Number of times EVC reference IDs are invalid in Ethernet LMI packets.
Invalid Message Type	Number of message types that are not valid for LMI.
Out of Sequence IE	Number of information elements (IEs) that are not in the correct sequence.
Duplicated IE	Number of duplicated IEs.
Mandatory IE Missing	Number of mandatory IEs that are missing.
Invalid Mandatory IE	Number of mandatory IEs that are invalid.
Invalid non-Mandatory IE	Number of non-mandatory IEs that are invalid.
Unrecognized IE	Number of IEs that are not recognized.
Unexpected IE	Number of IEs that are unexpected.
Short Message	Number of times the Ethernet LMI message received is shorter than supported packets.
Last Full Status Enq Sent	Time in hours, minutes, and seconds when the CE sent the last full LMI status request.
Last Full Status Rcvd	Time in hours, minutes, and seconds when the CE received the last full LMI status report.
Last Status Check Sent	Time in hours, minutes, and seconds when the CE sent the last LMI status request.
Last Status Check Rcvd	Time in hours, minutes, and seconds when the CE received the last LMI status report.
Last clearing of counters	Time in hours, minutes, and seconds when the clear ethernet lmi statistics command was issued for the interface.

The following sample output is generated from the show ethernet lmi command using the uni map keyword:

Router# show ethernet lmi uni map

UNI Id                            EVC Id                            Port        

--------------------------------- --------------------------------- ------------

uni_sandiego                      EVC_MP2MP_101                     Gi0/1       

uni_sandiego                      EVC_P2P_110                       Gi0/1       

Router#

The following sample output is generated from the show ethernet lmi command using the uni map and optional interface keywords:

Router# show ethernet lmi uni map interface gigabitethernet 0/1

UNI Id                            EVC Id                            Port        

--------------------------------- --------------------------------- ------------

uni_sandiego                      EVC_MP2MP_101                     Gi0/1       

uni_sandiego                      EVC_P2P_110                       Gi0/1       

Router#

Table 21 describes the significant fields shown in output of the show ethernet lmi command using the uni map keyword and uni map and interface keyword pair.

Table 21 show ethernet lmi uni map and uni map interface Field Descriptions

Field	Description
UNI Id	Identifier of the UNI.
EVC Id	Identifier of the EVC.
Port	Interface on the CE device.

show ethernet mac-tunnel engine slot

To display Ethernet MAC-in-MAC information, use the show ethernet mac-tunnel engine slot command in privileged EXEC mode.

show ethernet mac-tunnel engine slot slot-num

Syntax Description

slot-num

Integer from 1 to 4294967295 that identifies a MAC tunnel engine slot.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRE	This command was introduced.

Usage Guidelines

This command is used to find the B-component source address (B-SA) used in MAC-in-MAC encapsulations.

Examples

The following is sample output from the show ethernet mac-tunnel engine slot command:

Router# show ethernet mac-tunnel engine slot 3

Tunnel-engine							B-MAC Address 

0			 				001d.e5e8.2274

1							001d.e5e8.2275

Table 22 describes the significant fields shown in the display.

Table 22 show ethernet mac-tunnel engine slot Field Descriptions 

Field	Description
Tunnel-engine	MAC tunnel identifier.
B-MAC Address	B-SA MAC address.

show ethernet oam debug link-monitor

To display the Ethernet Operations, Administration, and Maintenance (OAM) debug link monitoring information on an interface, use the show ethernet oam debug link-monitor command in privileged EXEC mode.

show ethernet oam debug link-monitor [interface type number]

Syntax Description

interface	(Optional) Displays the link monitoring information on an interface.
type	(Optional) Displays the interface type.
number	(Optional) Displays the interface number.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.0(1)M	This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.

Usage Guidelines

Use the show ethernet oam debug link-monitor command to display Ethernet OAM debug link monitoring information on an interface.

Examples

The following is sample output from the show ethernet oam debug link-monitor command:

Router# show ethernet oam debug link-monitor interface gigabitEthernet 0/1 

Interface Gi0/1:

first_poll = 1

symprd_tlv_sent = 0

frmprd_tlv_sent = 0

frm_poll_cnt = 1

frmsec_poll_cnt = 10

rxcrc_poll_cnt = 1

txcrc_poll_cnt = 1

symbol_period_start = never

prev_rx_error_frames = 0

total_rx_error_frames = 0

error_frame_period_start = 0

total_frame_period_start = 0

prev_error_frame_seconds = 0

total_error_frame_seconds = 0

prev_rx_crc_error_frames = 0

prev_tx_crc_error_frames = 0

total_frm_tlvs = 0

total_frmsec_tlvs = 0

total_symprd_tlvs = 0

total_frmprd_tlvs = 0

Table 23 describes the significant fields shown in the display.

Table 23 ethernet oam debug link-monitor Field Descriptions 

Field	Description
Interface	Specifies the interface type.
first_poll	Specifies the number of counters copied in the first poll.
frmprd_tlv_sent	Specifies the number of error frame period events that are sent.
frm_poll_cnt	Specifies number of frames polled.
rxcrc_poll_cnt	Specifies the Received (RX) cyclic redundancy checks (CRCs) poll count.
txcrc_poll_cnt	Specifies the Transmitter (TX) CRCs poll count.
symbol_period_start	Specifies the symbol period start.
prev_rx_error_frames	Specifies the previous error symbol period.
total_frm_tlvs	Specifies the total number of error frames received.
total_frmsec_tlvs	Specifies the total number of frames received (in seconds) and the type length values (TLVs) for each frame.
total_symprd_tlvs	Specifies the total symbol period and the TLVs received for each frame.
total_frmprd_tlvs	Specifies the total frame period and the TLVs received for each frame.

show ethernet oam discovery

To display discovery information for all Ethernet operations, maintenance, and administration (OAM) interfaces or for a specific interface, use the show ethernet oam discovery command in privileged EXEC mode.

show ethernet oam discovery [interface type number]

Syntax Description

interface	(Optional) Specifies an interface.
type	(Optional) Type of Ethernet interface. Valid values are: FastEthernet, GigabitEthernet, TenGigabitEthernet.
number	(Optional) Integer from 1 to 9 that is the number of the Ethernet interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

This command displays the following information pertaining to Ethernet OAM discovery:

•Remote device which is directly connected to this device

•Local and remote OAM configuration and capability

•Local and remote OAM mode

•Remote platform identity

•State of the local discovery state machine

If an interface is specified, only data pertaining to the OAM peer on that interface is displayed; otherwise, data for all OAM peers (on all interfaces) is displayed.

Examples

The following example shows output from a show ethernet oam discovery command for interface GigabitEthernet 6/11:

Router# show ethernet oam discovery interface gigabitethernet6/11

GigabitEthernet6/11

Local client

------------

  Administrative configurations:

    Mode:              active

    Unidirection:      not supported

    Link monitor:      supported (on)

    Remote loopback:   supported

    MIB retrieval:     not supported

    Mtu size:          1500

Operational status:

    Port status:       operational

    Loopback status:   no loopback

    PDU revision:      1

Remote client

-------------

  MAC address: 0030.96fd.6bfa

  Vendor(oui): 0x00 0x00 0x0C (cisco)

  Administrative configurations:

    Mode:              active

    Unidirection:      not supported

    Link monitor:      supported

    Remote loopback:   supported

    MIB retrieval:     not supported

    Mtu size:          1500

Table 24 describes the significant fields shown in the display.

Table 24 show ethernet oam discovery Field Descriptions 

Field	Description
Administrative configurations
Mode	Active or passive mode of the interface
Unidirection	Operational mode
Link monitor	Status of link monitor support
Remote loopback	Status of remote loopback support
MIB retrieval	Capability of requesting MIB objects.
Mtu size	Size of the maximum transmission unit
Operational status
Port status	Operational state of the port
Loopback status	Operational status of the loopback interface
PDU revision	Revision of the OAM configuration. A new revision results from each change to the configuration.
Remote client
MAC address	MAC address of the remote client
Vendor (oui)	Vendor number in hexidecimal

Related Commands

Command	Description
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam runtime

To display Ethernet Operations, Maintenance, and Administration (OAM) runtime configurations for all interfaces or for a specific interface, use the show ethernet oam runtime command in either user EXEC or privileged EXEC mode.

show ethernet oam runtime interface type number

Syntax Description

interface	Specifies an interface.
type number	Interface type and number.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release	Modification
12.4(24)T	This command was introduced in a release earlier than Cisco IOS Release 12.4(24)T.
12.2(33)SRC	This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
12.2(33)SXH	This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

Use this command to display the runtime settings of link-monitoring and general OAM operations for all interfaces or for a specific interface.

OAM must be operational on the interface or interfaces before you issue this command.

Examples

The following is sample output from the show ethernet oam runtime command for Fast Ethernet interface 3/1:

Router# show ethernet oam runtime interface fastethernet 3/1

Runtime Settings:

-----------------

local_pdu: info

local_mux: fwd

local_par: fwd

local_link_status: OK

local_satisfied: No

local_stable: No

enter_loopback: No

pdu_cnt: 10

pdu_timer: Running

lost_link_timer: stopped

loopback_timer: stopped(timeout=2)

remote_state_valid: No

remote_stable: No

remote_evaluating: 0

peer version: 3

State Machine:

--------------

sm(ether_oam_port Fa0/0), running yes, state ACTIVE_SEND_LOCAL

Table 25 describes the significant fields shown in the display.

Table 25 show ethernet oam runtime Field Descriptions 

Field	Description
Runtime Settings
local_pdu	Information about the number of protocol data units (PDUs) transmitted per second.
local_mux	Indicates the state of the multiplexer function of the OAM sublayer.
local_par	Indicates the state of the parser function of the OAM sublayer.
local_link_status	Status of link support.
local_satisfied	Indicates the result of comparing its local configuration and the remote configuration found in the received local information type length value (TLV) field.
local_stable	Indicates the OAM client state information in the discovery process.
pdu_cnt	Displays the count of PDUs.
pdu_timer	Time taken for PDU transmission.
lost_link_timer	Amount of time with inactivity before the link is dropped.
loopback_timer	Specified time taken by the loopback interface.
remote_state_valid	Indicates the OAM client has received remote state information.
remote_stable	Indicates remote OAM client acknowledgment of local OAM state information.
peer version	Version of the OAM peer.
State Machine	Displays information of the finite state machine.

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam statistics

To display detailed information about Ethernet operations, maintenance, and administration (OAM) packets, use the show ethernet oam statistics command in privileged EXEC mode.

show ethernet oam statistics [interface type number]

Syntax Description

interface	(Optional) Specifies an interface.
type	(Optional) Type of Ethernet interface. Valid values are: FastEthernet, GigabitEthernet, TenGigabitEthernet.
number	(Optional) Integer from 1 to 9 that is the number of the Ethernet interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

Statistics that this command displays include the following:

•Rx/Tx OAM Protocol Data Unit (PDU) counters

•Link monitoring events, including event logs, if available

•Remote fault detection events

•Remote loopback events

Examples

The following example shows output from a show ethernet oam statistics command for interface GigabitEthernet 6/11:

Router# show ethernet oam statistics interface gigabitethernet 6/11

GigabitEthernet6/11

Counters:

---------

  Information OAMPDU Tx                   : 9723

  Information OAMPDU Rx                   : 9712

  Unique Event Notification OAMPDU Tx     : 0

  Unique Event Notification OAMPDU Rx     : 0

  Duplicate Event Notification OAMPDU TX  : 0

  Duplicate Event Notification OAMPDU RX  : 0

  Loopback Control OAMPDU Tx              : 0

  Loopback Control OAMPDU Rx              : 0

  Variable Request OAMPDU Tx              : 0

  Variable Request OAMPDU Rx              : 0

  Variable Response OAMPDU Tx             : 0

  Variable Response OAMPDU Rx             : 0

  Cisco OAMPDU Tx                         : 0

  Cisco OAMPDU Rx                         : 0

  Unsupported OAMPDU Tx                   : 0

  Unsupported OAMPDU Rx                   : 0

  Frames Lost due to OAM                  : 0

Local event logs:

-----------------

  0 Errored Symbol Period records

  0 Errored Frame records

  0 Errored Frame Period records

  0 Errored Frame Second records

Remote event logs:

------------------

  0 Errored Symbol Period records

  0 Errored Frame records

  0 Errored Frame Period records

  0 Errored Frame Second records

Table 26 describes the significant fields shown in the display.

Table 26 show ethernet oam statistics Field Descriptions 

Field	Description
Counters
Information OAMPDU Tx	Number of OAM PDUs transmitted
Information OAMPDU Rx	Number of OAM PDUs received
Unique Event Notification OAMPDU Tx	Number of unique event notification OAM PDUs transmitted
Unique Event Notification OAMPDU Rx	Number of unique event notification OAM PDUs received
Duplicate Event Notification OAMPDU Tx	Number of duplicate event notification OAM PDUs transmitted
Duplicate Event Notification OAMPDU Rx	Number of duplicate event notification OAM PDUs received
Loopback Control OAMPDU Tx	Number of loopback control OAM PDUs transmitted
Loopback Control OAMPDU Rx	Number of loopback control OAM PDUs received
Variable Request OAMPDU Tx	Number of OAM PDUs sent to request MIB objects on a remote device
Variable Request OAMPDU Rx	Number of OAM PDUs received and requesting MIB objects on a local device
Variable Response OAMPDU Tx	Number of OAM PDUs sent by the local device in response to a request from a remote device
Variable Response OAMPDU Rx	Number of OAM PDUs sent by the remote device in response to a request from a local device
Cisco OAMPDU Tx	Number of Cisco specific OAM PDUs sent
Cisco OAMPDU Rx	Number of Cisco specific OAM PDUs received
Unsupported OAMPDU Tx	Number of unsupported OAM PDUs sent
Unsupported OAMPDU Rx	Number of unsupported OAM PDUs received
Frames lost due to OAM	Number of frames discarded by the OAM client
Local event logs	Log of events on the local device
Remote event logs	Log of events on the remote device

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam status

To display Ethernet operations, maintenance, and administration (OAM) configurations for all interfaces or for a specific interface, use the show ethernet oam status command in privileged EXEC mode.

show ethernet oam status [interface type slot/[subslot/]port | vlan vlan]

Syntax Description

interface	(Optional) Specifies an interface.
type	(Optional) Type of Ethernet interface. Valid values are: FastEthernet, GigabitEthernet, TenGigabitEthernet.
slot/[subslot/]port	(Optional) Chassis slot number and port number where the Ethernet interface is located. If the Ethernet interface is located on a shared port adapter (SPA), the subslot number may also be required. The subslot is the secondary slot number on the SPA Interface Processor (SIP) where the SPA is installed.
vlan vlan	(Optional) Limits the display to interfaces on the specified VLAN. Range: 1 to 4094

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI	This command was changed to add the optional vlan vlan keyword and argument. The subslot field was added to support Ethernet interfaces located on a SPA.

Usage Guidelines

Use this command to display the runtime settings of link-monitoring and general OAM operations for all interfaces or for a specific interface.

OAM must be operational on the interface or interfaces before you issue this command.

Cisco IOS Release 12.2(33)SXI and later releases allow you to limit the display of switch port information to the specified VLAN.

Examples

The following example shows output from a show ethernet oam status command for interface GigabitEthernet 6/11:

Router# show ethernet oam status interface gigabitethernet 6/11

GigabitEthernet6/11

General

-------

  Mode:                  active

  PDU max rate:          10 packets per second

  PDU min rate:          1 packet per 1 second

  Link timeout:          5 seconds

  High threshold action: no action

Link Monitoring

---------------

  Status: supported (on)

  Symbol Period Error

    Window:              1 million symbols

    Low threshold:       1 error symbol(s)

    High threshold:      none

  Frame Error

    Window:              10 x 100 milliseconds

    Low threshold:       1 error frame(s)

    High threshold:      none

  Frame Period Error

    Window:              1 x 100,000 frames

    Low threshold:       1 error frame(s)

    High threshold:      none

  Frame Seconds Error

    Window:              600 x 100 milliseconds

    Low threshold:       1 error second(s)

    High threshold:      none

Table 27 describes the significant fields shown in the display.

Table 27 show ethernet oam status Field Descriptions 

Field	Description
General
Mode	Active or passive mode of the interface.
PDU max rate	Maximum number of protocol data units (PDUs) transmitted per second.
PDU min rate	Minimum number of PDUs transmitted per second.
Link timeout	Amount of time with inactivity before the link is dropped.
High threshold action	Action that occurs when the high threshold for an error is exceeded.
Link Monitoring
Status	Operational state of the port.
Symbol Period Error
Window	Specified number of error symbols.
Low threshold	Minimum number of error symbols.
High threshold	Maximum number of error symbols.
Frame Error
Window	Specified amount of time in milliseconds.
Low threshold	Minimum number of error frames.
High threshold	Maximum number of error frames.
Frame Period Error
Window	Frequency at which the measurement is taken, in milliseconds.
Low threshold	Minimum number of error frames.
High threshold	Maximum number of error frames.
Frame Seconds Error
Window	Frequency at which the measurement is taken, in milliseconds.
Low threshold	Lowest value at which an event will be triggered.
High threshold	Highest value at which an event will be triggered.

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.
show ethernet oam summary	Displays active Ethernet OAM sessions.

show ethernet oam summary

To display active Ethernet operations, maintenance, and administration (OAM) sessions on a device, use the show ethernet oam summary command in privileged EXEC mode.

show ethernet oam summary

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Examples

The following example shows output from a show ethernet oam summary command:

Router# show ethernet oam summary

Symbols:          * - Master Loopback State,  # - Slave Loopback State

Capability codes: L - Link Monitor,  R - Remote Loopback

                  U - Unidirection,  V - Variable Retrieval

  Local                       Remote

Interface       MAC Address    Vendor Mode    Capability

  Fa3/1         0080.09ff.e4a0 00000C active   L R

  Gi6/11        0030.96fd.6bfa 00000C active   L R

Table 28 describes the significant fields shown in the display.

Table 28 show ethernet oam summary Field Descriptions 

Field	Description
Local Interface	Type of local interface
MAC Address	MAC address of the local interface
Remote Vendor	The vendor for the remote device.
Mode	Operational state of the remote interface
Capability	Functions the local interface can perform

Related Commands

Command	Description
show ethernet oam discovery	Displays discovery information for all Ethernet OAM interfaces or for a specific interface.
show ethernet oam status	Displays Ethernet OAM configurations for all interfaces or for a specific interface.
show ethernet oam statistics	Displays detailed information about Ethernet OAM packets.

show ethernet service evc

To display information about Ethernet virtual connections (EVCs), use the show ethernet service evc command in privileged EXEC mode.

show ethernet service evc [detail | id evc-id [detail] | interface type number [detail]]

Syntax Description

detail	(Optional) Displays detailed information about service instances or the specified service instance ID or interface.
id	(Optional) Displays EVC information for the specified service.
evc-id	(Optional) String from 1 to 100 characters that identifies the EVC.
interface	(Optional) Displays service instance information for the specified interface.
type	(Optional) Type of interface.
number	(Optional) Number of the interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was integrated into Cisco IOS Release 12.2(33)SRB.

Usage Guidelines

This command is useful for system monitoring and troubleshooting.

Examples

Following is sample output from the show ethernet service evc command:

Router# show ethernet service evc

Identifier                     Type  Act-UNI-cnt Status

BLUE                           P-P       2       Active         

PINK                           MP-MP     2       PartiallyActive

PURPLE                         P-P       2       Active         

BROWN                          MP-MP     2       Active         

GREEN                          P-P       3       Active         

YELLOW                         MP-MP     2       PartiallyActive

BANANAS                        P-P       0       InActive       

TEST2                          P-P       0       NotDefined     

ORANGE                         P-P       2       Active         

TEAL                           P-P       0       InActive 

Table 29 describes the significant fields in the output.

Table 29 show ethernet service evc Field Descriptions 

Field	Description
Identifier	EVC identifier.
Type	Type of connection, for example point-to-point (P-P) or multipoint-to-multipoint (MP-MP).
Act-UNI-cnt	Number of active user network interfaces (UNIs).
Status	Availability status of the EVC.

Related Commands

Command	Description
show ethernet instance	Displays information about Ethernet customer service instances.
show ethernet interface	Displays interface-only information about Ethernet customer service instances.

show ethernet service instance

To display information about Ethernet service instances, use the show ethernet service instance command in privileged EXEC mode.

show ethernet service instance [detail | id id {interface type number [detail | mac {security [address | last violation | statistics] | static address}] | load-balance | mac-tunnel [detail]} | platform | stats] | interface type number [detail | load-balance | platform | stats | summary] | mac security [address | last violation | statistics] | platform | policy-map | stats | summary]

Syntax Description

detail	(Optional) Displays detailed information about service instances, a specific service instance, or about a MAC tunnel service instance.
id	(Optional) Displays a specific service instance on an interface that does not map to a VLAN.
id	(Optional) Integer from 1 to 4294967295 that identifies a service instance on an interface that does not map to a VLAN.
interface	(Optional) Declares a specific interface selection for a specified service instance.
type	(Optional) Type of interface.
number	(Optional) Number of the interface.
mac	(Optional) Displays MAC address data.
security	(Optional) Displays the MAC security status of a specified service instance.
address	(Optional) Displays the secure addresses on the specified service instance.
last violation	(Optional) Displays the last violation recorded on the specified service instance.
statistics	(Optional) Displays MAC security statistics for the specified service instance.
static	(Optional) Displays MAC static address information.
address	(Optional) Displays MAC static addresses in a bridge domain.
load-balance	(Optional) Displays EtherChannel load-balancing information.
mac-tunnel	(Optional) Displays the MAC tunnel Ethernet service instance identifier.
platform	(Optional) Displays platform information for a specified service instance.
stats	(Optional) Displays statistics for a specified service instance.
summary	(Optional) Displays summary information about service instances.
policy-map	(Optional) Displays the policy map for service instances.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was integrated into Cisco IOS Release 12.2(33)SRB.
12.2(33)SRD	This command was modified. The address, detail, last violation, mac security, platform, statistics, stats, and summary keywords were added.
12.2(33)SRE	This command was modified. The address, mac-tunnel, and static keywords were added.
15.0(1)S	This command was modified. The load-balance keyword was added.

Usage Guidelines

This command is useful for system monitoring and troubleshooting.

Examples

The following is sample output from the show ethernet service instance command:

Router# show ethernet service instance

Identifier Interface             CE-Vlans

222        FastEthernet0/1       untagged,1-4094

10         FastEthernet0/2

222        FastEthernet0/2       200

333        FastEthernet0/2       default

10         FastEthernet0/3       300

11         FastEthernet0/3

10         FastEthernet0/4       300

10         FastEthernet0/6       untagged,1-4094

10         FastEthernet0/7       untagged,1-4094

10         FastEthernet0/8       untagged,1-4094

10         FastEthernet0/9       untagged

20         FastEthernet0/9

222        FastEthernet0/11      300-350,900-999

333        FastEthernet0/11      100-200,1000,1999-4094

222        FastEthernet0/12      20

333        FastEthernet0/12      10

10         FastEthernet0/13      10

20         FastEthernet0/13      20

30         FastEthernet0/13      30

200        FastEthernet0/13      222

200        FastEthernet0/14      200,222

300        FastEthernet0/14      333

555        FastEthernet0/14      555

Table 30 describes the significant fields shown in the display.

Table 30 show ethernet service instance Field Descriptions 

Field	Description
Identifier	Service instance identifier.
Interface	Interface type and number with which the service instance is associated.
CE-Vlans	Customer edge (CE) device VLAN ID.

Related Commands

Command	Description
clear ethernet service instance	Clears Ethernet service instance attributes such as MAC addresses and statistics and purges Ethernet service instance errors.
show ethernet service interface	Displays interface-only information about Ethernet customer service instances.

show ethernet service interface

To display interface-only information about Ethernet customer service instances for all interfaces or for a specified interface, use the show ethernet service interface privileged EXEC mode.

show ethernet service interface [type number] [detail]

Syntax Description

type	(Optional) Type of interface.
number	(Optional) Number of the interface.
detail	(Optional) Displays detailed information about interfaces or a specified service instance ID or interface.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was integrated into Cisco IOS Release 12.2(33)SRB.

Usage Guidelines

Expressions are case sensitive. For example, if you enter | exclude output, the lines that contain output are not displayed, but the lines that contain "Output" are displayed.

Examples

Following are examples of output from the show ethernet service interface command:

Router# show ethernet service interface gigabitethernet0/1

Interface          Identifier

GigabitEthernet0/1 PE2-G101

Router# show ethernet service interface detail

Interface: FastEthernet0/1

ID:

CE-VLANS:

EVC Map Type: Bundling-Multiplexing

Interface: FastEthernet0/2

ID:

CE-VLANS:

EVC Map Type: Bundling-Multiplexing

Interface: FastEthernet0/3

ID:

CE-VLANS:

EVC Map Type: Bundling-Multiplexing

<output truncated>

Interface: GigabitEthernet0/1

ID: PE2-G101

CE-VLANS: 10,20,30

EVC Map Type: Bundling-Multiplexing

Associated EVCs:

EVC-ID CE-VLAN

WHITE 30

RED 20

BLUE 10

Associated Service Instances:

Service-Instance-ID CE-VLAN

10 10

20 20

30 30

Table 31 describes the significant fields in the output.

Table 31 show ethernet service interface Field Descriptions 

Field	Description
Interface	Interface type and number.
Identifier	EVC identifier.
ID	EVC identifier.
CE-VLANS	VLANs associated with the customer edge (CE) device.
EVC Map Type	UNI service type; for example, Bundling, Multiplexing, All-to-one Bundling.
Associated EVCs	EVCs associated with a device.
EVC-ID CE-VLAN	EVC identifier and associated VLAN.
Associated Service Instances	Service instances associated with a device.
Service-Instance-ID CE-VLAN	Service instance identifier and its associated CE VLAN.

Related Commands

Command	Description
service instance ethernet	Defines an Ethernet service instance and enters Ethernet service configuration mode.
show ethernet evc	Displays information about Ethernet customer service instances.
show ethernet interface	Displays interface-only information about Ethernet customer service instances.

show ethernet service mac-tunnel

To display information about MAC tunnels, use the show ethernet service mac-tunnel command in privileged EXEC mode.

show ethernet service mac-tunnel {id [detail] | summary}

Syntax Description

id	Integer from 1 to 2147483647 that identifies a MAC-in-MAC tunnel.
detail	Displays detailed information about a MAC-in-MAC tunnel.
summary	Displays summary information about a MAC-in-MAC tunnel.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRE	This command was introduced.

Usage Guidelines

This command is useful for system monitoring and troubleshooting.

Examples

The following is sample output of the show ethernet service mac-tunnel command:

Router# show ethernet service mac-tunnel 1 detail tunnel id 1

State: Up

EFP Microblocks:

****************

Microblock type: Bridge-domain

Bridge-domain: 10

No. of Service Instances: 1

Service Instance ID: 1

Associated Tunnel Id: 1

Encapsulation: dot1ah 1 vlan-type 0x88E7

State: Up

Mac-flush: MIRP enabled/MIRP cos 7

EFP Microblocks:

****************

Microblock type: Bridge-domain

Bridge-domain: 1 c-mac

Table 32 describes the significant fields shown in the display.

Table 32 show ethernet service mac-tunnel detail Field Descriptions 

Field	Description
State	Operational state of the MAC tunnel.
EFP Microblocks	Mechanism for external components to store information in the EFP structure.
Microblock type	Type of microblock. In this case, bridge domain is the microblock.
No. of Service Instances	Number of service instances configured under the MAC tunnel.
Service Instance ID	Service instance identifier.
Associated Tunnel Id	ID of the MAC tunnel under which the service instance is configured.
Encapsulation	Type of encapsulation used for the service instance.
Mac-flush	Type of remote MAC address flush mechanism that is currently supported. In this case, it is Multiple I-SID Registration Protocol (MIRP).
Bridge-domain: 1 c-mac	Type of bridge domain configured.

Router# show ethernet service mac-tunnel summary

            Total       Up  AdminDo     Down  ErrorDi  Unknown  Deleted  BdAdmDo  

bdomain         1        1        0        0        0        0        0        0  

other           0        0        0        0        0        0        0        0  

Associated Tunnel Id: 1

            Total       Up  AdminDo     Down  ErrorDi  Unknown  Deleted  BdAdmDo  

bdomain         1        1        0        0        0        0        0        0  

other           0        0        0        0        0        0        0        0 

Table 33 describes the significant fields shown in the display.

Table 33 show ethernet service mac-tunnel summary Field Descriptions 

Field	Description
Total	Total number of bridge domains or other forwarding mechanisms configured.
Up	Number of bridge domains or other forwarding mechanisms that are operational.
AdminDo	Number of bridge domains or other forwarding mechanisms that are administratively shut down.
Down	Number of bridge domains or other forwarding mechanisms that are not operational.
ErrorDi	Number of bridge domains or other forwarding mechanisms that are disabled.
Unknown	Number of bridge domains or other forwarding mechanisms for which operational status is unknown.
Deleted	Number of configurations removed.
BdAdmDo	Indicates that the bridge domain was shut down.
bdomain	Bridge domain.
other	Any forwarding mechanism other than a bridge domain.
Associated Tunnel Id	ID of the MAC tunnel under which the service instance is configured.

show lacp

To display Link Aggregation Control Protocol (LACP) and multi-chassis LACP (mLACP) information, use the show lacp command in either user EXEC or privileged EXEC mode.

show lacp {channel-group-number {counters | internal [detail] | multi-chassis {group number | port-channel num | neighbor [detail]} | counters | internal [detail] | neighbor [detail] | sys-id}

Syntax Description

channel-group- number	Number of the channel group; following are valid values: •Cisco IOS 12.2 SB and Cisco IOS XE 2.4 releases—from 1 to 64 •Cisco IOS 12.2 SR releases—from 1 to 308 •Cisco IOS 12.2 SX releases—from 1 to 496
counters	Displays information about the LACP traffic statistics.
detail	(Optional) Detailed internal information.
internal	Displays LACP internal information.
multi-chassis	Displays information about mLACP.
group	Displays mLACP redundancy group information,
number	Integer value used with the group and port-channel keywords. •Values from 1 to 4294967295 identify the redundancy group. •Values from 1 to 564 identify the port-channel interface.
port-channel	Displays mLACP port-channel information.
neighbors	Displays information about the LACP neighbor.
sys-id	Displays the LACP system identification. It is a combination of the port priority and the MAC address of the device

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release	Modification
12.2(14)SX	Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB	Support for this command on the Supervisor Engine 2 was extended to Cisco IOS Release 12.2(17d)SXB.
12.2(33)SRA	This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2	This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB	Support for this command on the Cisco 7600 router was integrated into Cisco IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.4	This command was integrated into Cisco IOS XE Release 2.4.
12.2(33)SRE	This command was modified. The multi-chassis, group, and port-channel keywords and number argument were added.

Usage Guidelines

Use the show lacp command to troubleshoot problems related to LACP in a network.

If you do not specify a value for the argument channel-group-number, all channel groups are displayed. Values in the range of 257 to 282 are supported on the CSM and the FWSM only.

You can enter the optional channel-group-number to specify a channel group for all keywords except the sys-id keyword.

Examples

show lacp sys-id Example

This example shows how to display the LACP system identification using the show lacp sys-id command:

Router> show lacp sys-id

8000,AC-12-34-56-78-90

The system identification is made up of the system priority and the system MAC address. The first two bytes are the system priority, and the last six bytes are the globally administered individual MAC address that is associated to the system.

LACP Statistics for a Specific Channel Group Examples

This example shows how to display the LACP statistics for a specific channel group:

Router# show lacp 1 counters

              LACPDUs         Marker       LACPDUs

Port       Sent   Recv     Sent   Recv     Pkts Err

---------------------------------------------------

Channel group: 1

  Fa4/1    8      15       0      0         3    0

  Fa4/2    14     18       0      0         3    0

  Fa4/3    14     18       0      0         0

  Fa4/4    13     18       0      0         0

The output displays the following information:

•The LACPDUs Sent and Recv columns display the LACPDUs that are sent and received on each specific interface.

•The LACPDUs Pkts and Err columns display the marker-protocol packets.

The following example shows output from a show lacp channel-group-number counters command:

Router1# show lacp 5 counters

             LACPDUs         Marker      Marker Response    LACPDUs

Port       Sent   Recv     Sent   Recv     Sent   Recv      Pkts Err

---------------------------------------------------------------------

Channel group: 5

Gi5/0/0     21     18       0      0        0      0         0     

Table 34 describes the significant fields shown in the sample output of the show lacp counters command.

Table 34 show lacp number counters Field Descriptions 

Field	Description
LACPDUs Sent Recv	Number of LACP PDUs sent and received.
Marker Sent Recv	Attempts to avoid data loss when a member link is removed from an LACP bundle.
Marker Response Sent Recv	Cisco IOS response to the Marker protocol.
LACPDUs Pkts Err	Number of LACP PDU packets transmitted and the number of packet errors.

The following example shows output from a show lacp internal command:

Router1# show lacp 5 internal

Flags:  S - Device is requesting Slow LACPDUs 

        F - Device is requesting Fast LACPDUs

        A - Device is in Active mode       P - Device is in Passive mode     

Channel group 5

                            LACP port     Admin     Oper    Port        Port

Port      Flags   State     Priority      Key       Key     Number      State

Gi5/0/0   SA      bndl      32768         0x5       0x5     0x42        0x3D

Table 35 describes the significant fields shown in the sample output of the show lacp internal command.

Table 35 show lacp internal Field Descriptions 

Field	Description
Flags	Meanings of each flag value, which indicates a device activity.
Port	Port on which link bundling is configured.
Flags	Indicators of device activity.
State	Activity state of the port. States can be any of the following: •Bndl—Port is attached to an aggregator and bundled with other ports. •Susp—Port is in suspended state, so it is not attached to any aggregator. •Indep—Port is in independent state (not bundled but able to switch data traffic). This condition differs from the previous state because in this case LACP is not running on the partner port. •Hot-sby—Port is in hot standby state. •Down—Port is down.
LACP port Priority	Priority assigned to the port.
Admin Key	Defines the ability of a port to aggregate with other ports.
Oper Key	Determines the aggregation capability of the link.
Port Number	Number of the port.
Port State	State variables for the port that are encoded as individual bits within a single octet with the following meaning: •bit0: LACP_Activity •bit1: LACP_Timeout •bit2: Aggregation •bit3: Synchronization •bit4: Collecting •bit5: Distributing •bit6: Defaulted •bit7: Expired

Internal Information About a Specific Channel Group Example

This example shows how to display internal information for the interfaces that belong to a specific channel:

Router# show lacp 1 internal

Flags:  S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.

        A - Device is in Active mode.       P - Device is in Passive mode. 

Channel group 1

                            LACPDUs     LACP Port    Admin   Oper    Port     Port

Port      Flags    State    Interval    Priority     Key     Key     Number   State

Fa4/1     saC      bndl     30s         32768        100     100     0xc1     0x75

Fa4/2     saC      bndl     30s         32768        100     100     0xc2     0x75

Fa4/3     saC      bndl     30s         32768        100     100     0xc3     0x75

Fa4/4     saC      bndl     30s         32768        100     100     0xc4     0x75

Router# 

Table 36 describes the fields that are shown in the example.

Table 36 show lacp internal Command Output Fields 

Field	Description
State	Current state of the port; allowed values are as follows: •bndl—Port is attached to an aggregator and bundled with other ports. •susp—Port is in a suspended state; it is not attached to any aggregator. •indep—Port is in an independent state (not bundled but able to switch data traffic. In this case, LACP is not running on the partner port). •hot-sby—Port is in a hot-standby state. •down—Port is down.
LACPDUs Interval	Interval setting.
LACP Port Priority	Port-priority setting.
Admin Key	Defines the ability of a port to aggregate with other ports.
Oper Key	Determines the aggregation capability of the link.
Port Number	Port number.
Port State	Activity state of the port. •See the Port State description in Table 35 for state variables.

Information About LACP Neighbors for a Specific Port Example

This example shows how to display the information about the LACP neighbors for a specific port channel:

Router# show lacp 1 neighbors

Flags:  S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.

        A - Device is in Active mode.       P - Device is in Passive mode.

Channel group 1 neighbors

          Partner                 Partner 

Port      System ID               Port Number     Age     Flags

Fa4/1     8000,00b0.c23e.d84e     0x81            29s     P

Fa4/2     8000,00b0.c23e.d84e     0x82            0s      P

Fa4/3     8000,00b0.c23e.d84e     0x83            0s      P 

Fa4/4     8000,00b0.c23e.d84e     0x84            0s      P

          Port          Admin     Oper      Port

          Priority      Key       Key       State

Fa4/1     32768         200       200       0x81

Fa4/2     32768         200       200       0x81

Fa4/3     32768         200       200       0x81

Fa4/4     32768         200       200       0x81

Router# 

Table 37 describes the fields that are shown in the example.

Table 37 show lacp neighbors Command Output Fields 

Field	Description
Port	Port on which link bundling is configured.
Partner System ID	Peer's LACP system identification (sys-id). It is a combination of the system priority and the MAC address of the peer device.
Partner Port Number	Port number on the peer device
Age	Number of seconds since the last LACP PDU was received on the port.
Flags	Indicators of device activity.
Port Priority	Port priority setting.
Admin Key	Defines the ability of a port to aggregate with other ports.
Oper Key	Determines the aggregation capability of the link.
Port State	Activity state of the port. See the Port State description in Table 35 for state variables.

If no PDUs have been received, the default administrative information is displayed in braces.

Related Commands

Command	Description
clear lacp counters	Clears the statistics for all interfaces belonging to a specific channel group.
lacp port-priority	Sets the priority for the physical interfaces.
lacp system-priority	Sets the priority of the system.

show lldp

To display information about one or all neighboring devices discovered using Link Layer Discovery Protocol (LLDP), use the show lldp command in privileged EXEC mode.

show lldp [entry {* | word} | errors | interface [ethernet number] | neighbors [ethernet number | detail] | traffic]

Syntax Description

entry	(Optional) Displays detailed information for a specific neighbor entry.
*	(Optional) Displays detailed information about all the LLDP neighbors.
word	(Optional) Name of the neighbor about which information is requested.
errors	(Optional) Displays LLDP computational errors and overflows.
interface	(Optional) Displays status and configuration of an interface on which LLDP is enabled.
ethernet	(Optional) Displays an IEEE 802.3 interface on which LLDP is enabled.
number	(Optional) Integer that identifies the interface.
neighbors	(Optional) Displays neighbor entries. Note If the device ID has more than 20 characters, the ID will be truncated to 20 characters in command output because of display constraints.
detail	(Optional) Displays detailed information about a neighbor (or neighbors) including network address, enabled capabilities, hold time, and software version.
traffic	(Optional) Displays LLDP statistics.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXH	This command was introduced.

Usage Guidelines

Use this command to monitor LLDP activity in a network.

When you use the neighbors keyword, the device ID is truncated to 20 characters in the command output because of display constraints. The show lldp neighbors command functions correctly; only the device ID display is truncated. For detailed neighbor information, use the show lldp neighbors detail command.

Examples

The following is sample output from the show lldp entry * command. Information about all the LLDP neighbors is displayed, including device ID, capabilities, addresses, hold time, and version.

Router# show lldp entry *

Capability codes:

    (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device

    (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Chassis id: aabb.cc00.1f01

Port id: Et1/0

Port Description: Ethernet1/0

System Name: R1.example.com

System Description:

Cisco IOS Software, Solaris Software (UNIX-JS-M)

12.2(20070524:210936) [user1-sierra-0522 105]

Copyright (c) 1986-2007 by Cisco Systems, Inc.

Compiled Fri 25-May-07 10:52 by user1

Time remaining: 136 seconds

System Capabilities: B,R

Enabled Capabilities: R

Management Addresses - not advertised

Auto Negotiation - not supported

Physical media capabilities - not advertised

Media Attachment Unit type - not advertised

---------------------------------------------

Total entries displayed: 1

Table 38 describes the significant fields in the output.

Table 38 show lldp entry * Field Descriptions 

Field	Description
Capability Codes	Type of device that can be discovered. Possible values are as follows: R—Router B—Bridge T—Telephone C—DOCSIS Cable Device W—WLAN Access Point P—Repeater S—Station O—Other
Chassis id	Identifier assigned to the device.
Port id	Identifier of the interface.
Port Description	Description of the interface.
System Name	Name of the device within the network.
System Description	Description of the software operating on the device.
Time remaining	Time remaining before the information is aged out.
System Capabilities	Possible capabilities of the device.
Enabled Capabilities	Subset of possible capabilities that are enabled.
Management Addresses	Layer 3 addresses of the management interface.
Auto Negotiation	Supported and enabled status of all interface autonegotiation capabilities.
Physical media capabilities	Physical characteristics of the interface on which LLDP operates.
Media Attachment Unit type	Numeric value representing the type of the media attachment unit.
Total entries displayed	Number of neighbor devices for which information is displayed.

The following is sample output from the show lldp neighbors command showing information about neighboring devices discovered using LLDP.

Router# show lldp neighbors

Capability codes:

    (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device

    (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Device ID           Local Intf     Hold-time  Capability      Port ID

R1                  Et1/0          150        R               Et1/0

Total entries displayed: 1

Table 39 describes the significant fields shown in the output.

Table 39 show lldp neighbors Field Descriptions

Field	Description
Capability Codes	See Table 38 for details.
Device ID	Name of the neighbor device. Note If the device ID has more than 20 characters, the ID will be truncated to 20 characters in command output because of display constraints.
Local Intf	Local interface through which this neighbor is connected.
Hold-time	Amount of time (in seconds) the current device will hold the LLDP advertisement from a sending device before discarding it.
Capability	Type of device listed in the LLDP Neighbors table. Values correspond to the values of the capability codes.
Port ID	Interface and port number of the neighboring device.
Total entries displayed	Number of neighbor devices for which information is displayed.

The following is sample output from the show lldp interface command for interface Ethernet 0/1:

Router# show lldp interface ethernet 0/1

Ethernet0/1:

    Tx: enabled

    Rx: enabled

    Tx state: IDLE

    Rx state: WAIT FOR FRAME

Table 40 describes the significant fields shown in the output.

Table 40 show lldp interface Field Descriptions

Field	Description
Tx	Ability of the interface to transmit advertisements.
Rx	Ability of the interface to receive advertisements.
Tx state	Current finite state machine state of the interface in transmit mode.
Rx state	Current finite state machine state of the interface in receive mode.

The following is sample output from the show lldp errors command:

Router# show lldp errors

LLDP errors/overflows:

    Total memory allocation failures: 0

    Total encapsulation failures: 0

    Total input queue overflows: 0

    Total table overflows: 0

Table 41 describes the significant fields shown in the output.

Table 41 show lldp errors Field Descriptions

Field	Description
Total memory allocation failures	Number of memory allocation failures.
Total encapsulation failures	Number of LLDP packet encapsulation failures.
Total input queue overflows	Number of times incoming advertisements exceeded the capacity of the LLDP input queue.
Total table overflows	Number of times the LLDP table rejected advertisements because it was full.

The following is sample output from the show lldp traffic command:

Router# show lldp traffic

LLDP traffic statistics:

    Total frames out: 277

    Total entries aged: 0

    Total frames in: 328

    Total frames received in error: 0

    Total frames discarded: 0

    Total TLVs unrecognized: 0

Table 42 describes the significant fields shown in the output.

Table 42 show lldp traffic Field Descriptions 

Field	Definition
Total frames out	Number of advertisements sent from the device.
Total entries aged	Number of neighbor device entries aged out.
Total frames in	Number of advertisements received by the device.
Total frames received in error	Number of times the LLDP advertisements contained errors of any type.
Total frames discarded	Number of times the LLDP process discarded an incoming advertisement.
Total TLVs unrecognized	Number of TLVs that could not be processed because the content of the TLV was not recognized by the device or the content fields were incorrectly specified.

show nmsp

To display the Network Mobility Services Protocol (NMSP) information, use the show nmsp command in privileged EXEC mode.

show nmsp {attachment suppress interface | capability | notification interval | statistics {connection | summary} | status | subscription {detail | summary}}

Syntax Description

attachment suppress interface	Displays attachment suppress interfaces.
capability	Displays switch capabilities including the supported services and subservices.
notification interval	Displays the notification intervals of the supported services.
statistics	Displays the NMSP statistics information. •connection—Displays the message counters on each connection. •summary—Displays the global counters.
status	Displays information about the NMSP connections.
subscription	Displays the subscription information on each NMSP connection. •detail—Displays all services and subservices subscribed on each connection. •summary—Displays all services subscribed on each connection.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(40)SE	This command was introduced.
12.2(55)SE	This command was modified. The output was enhanced to display all the interfaces that have been suppressed after the CDP Server TLV exchange takes place.

Usage Guidelines

You can use the Cisco IOS software output modifiers to filter the output of the show nmsp command, to display only those lines you are interested in.

The output modifier feature is invoked by using the pipe symbol (|). To use this feature, enter the show nmsp command with a space and the pipe symbol at the end of the command line, followed by one of the keywords shown in Table 43.

Table 43 Using Output Modifiers 

Command	Purpose
append regular-expression	Appends redirected output to URL (only to the URLs supporting the append operation).
begin regular-expression	Displays the first line that matches the regular expression, and then all other lines that follow that line.
include regular-expression	Displays all lines that match the regular expression.
exclude regular-expression	Displays all lines except those that match the regular expression.
format regular-expression	Formats the output using the specification file.
redirect regular-expression	Redirects the output to the URL.
section regular-expression	Filters a section of the output.
tee regular-expression	Copies output to the URL.

Examples

The following is sample output from the show nmsp attachment suppress interface command:

Router# show nmsp attachment suppress interface

NMSP Attachment Suppression Interfaces

--------------------------------------

 GigabitEthernet1/0/10    CLI Suppressed

 GigabitEthernet1/0/11    Internal Suppressed

The following is sample output from the show nmsp capability command:

Router# show nmsp capability

NMSP Switch Capability

------------------------------

Service          Subservice

-----------       --------------

Attachment    Wired Station

Location        Subscription

The following is sample output from the show nmsp notification interval command:

Router# show nmsp notification interval

NMSP Notification Intervals

----------------------------------

Attachment notify interval: 30 sec (default)

Location notify interval: 30 sec (default)

The following is sample output from the show nmsp statistics connection and show nmsp statistics summary commands:

Router# show nmsp statistics connection

NMSP Connection Counters

----------------------------------

Connection 1:

   Connection status: UP

   Freed connection: 0

   Tx message count       Rx message count

   -----------------------     -----------------------

   Subscr Resp: 1            Subscr Req: 1

   Capa Notif: 1              Capa Notif: 1

   Atta Resp: 1                Atta Req: 1

   Atta Notif: 0

   Loc Resp: 1                 Loc Req: 1

   Loc Notif: 0

Unsupported msg: 0

Router# show nmsp statistics summary

NMSP Global Counters

----------------------------

  Send too big msg: 0

  Failed socket write: 0

  Partial socket write: 0

  Socket write would block: 0

  Failed socket read: 0

  Socket read would block: 0

  Transmit Q full: 0

  Max Location Notify Msg: 0

  Max Attachment Notify Msg: 0

Max Tx Q Size: 0

The following is sample output from the show nmsp status command:

Router# show nmsp status

NMSP Status

----------------

NMSP: enabled

MSE IP Address    TxEchoResp RxEchoReq TxData RxData

172.19.35.109       5 5 4 4 

The following is sample output from the show nmsp subscription detail and the show nmsp subscription summary commands:

Router# show nmsp subscription detail

Mobility Services Subscribed by 172.19.35.109:

Services                Subservices

-----------------      -------------------

Attachment:          Wired Station

Location:               Subscription

Router# show nmsp subscription summary

Mobility Services Subscribed:

MSE IP Address     Services

--------------------     ---------------------

172.19.35.109	       Attachment, Location

Related Commands

Command	Description
clear nmsp statistics	Clears the NMSP statistic counters.
nmsp	Enables NMSP on a switch.

show ptp clock dataset

To display a summary of the Precision Time Protocol (PTP) clock status, use the show ptp clock dataset command in privileged EXEC mode.

show ptp clock dataset [default | current]

Syntax Description

default	(Optional) Displays the default PTP clock dataset.
current	(Optional) Displays the current PTP clock dataset.

Command Modes

Privileged EXEC

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Use this command to verify a PTP clocking configuration.

Examples

The following examples show the output generated by this command:

Router# show ptp clock dataset default

CLOCK [Boundary Clock, domain 10]

  Two Step Flag: No

  Clock Identity: 0x2A:0:0:0:58:67:F3:4

  Number Of Ports: 1

  Priority1: 89

  Priority2: 90

  Domain Number: 10

  Slave Only: No

  Clock Quality:

    Class: 224

    Accuracy: Unknown

    Offset (log variance): 4252

router# show ptp clock dataset current

CLOCK [Boundary Clock, domain 10]

  Steps Removed: 18522

  Offset From Master: 4661806827187470336

  Mean Path Delay: 314023819427708928

Table 44 describes significant fields shown in the display.

Table 44 show ptp clock dataset Field Descriptions 

Field	Description
Two Step Flag	Indicates whether the clock is sending timestamp information using a FOLLOW_UP message (a 2-step handshake) or not (a 1-step handshake).
Clock Identity	Unique identifier for the clock.
Number of Ports	Number of ports assigned to the PTP clock.
Priority1	Priority1 preference value of the PTP clock; the priority1 clock is considered first during clock selection.
Priority2	Priority2 preference value of the PTP clock; the priority2 clock is considered after all other clock sources during clock selection.
Domain number	PTP clocking domain number.
Slave only	Specifies whether the PTP clock is a slave-only clock.
Clock quality	Summarizes the quality of the grandmaster clock.
Class	Displays the time and frequency traceability of the grandmaster clock
Accuracy	Field applies only when the Best Master Clock algorithm is in use; indicates the expected accuracy of the master clock were the grandmaster clock.
Offset (log variance)	Offset between the local clock and an ideal reference clock.
Steps removed	Number of hops from the local clock to the grandmaster clock.
Offset From Master	Time offset between the slave and master clocks.
Mean Path Delay	Mean propagation time between the master and slave clocks.

show ptp clock dataset parent

To display a description of the Precision Time Protocol (PTP) parent clock, use the show ptp dataset parent command in privileged EXEC mode.

show ptp clock dataset parent

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Use this command to verify a PTP clocking configuration.

Examples

The following example shows the output generated by this command:

Router# show ptp clock dataset parent 

CLOCK [Boundary Clock, domain 10]

  Parent Stats: No

  Observed Parent Offset (log variance): 0

  Observed Parent Clock Phase Change Rate: 58087144

  Grandmaster Clock:

    Identity: 0x3E:D3:D0:0:0:0:0:0

    Priority1: 42

    Priority2: 0

    Clock Quality:

      Class: 176

      Accuracy: Unknown

      Offset (log variance): 4252

Table 45 describes significant fields shown in the display.

Table 45 show ptp clock dataset parent Field Descriptions 

Field	Description
Parent Stats	Indicates the availability of parent statistics.
Observed Parent Offset (log variance)	The offset between the parent clock and the local clock.
Observed Parent Clock Phase Change Rate	This value indicates the parent clock speed relative to the slave clock. A positive value indicates that the parent clock is faster than the slave clock; a negative value indicates that the parent clock is slower than the slave clock.
Grandmaster clock	Summarizes the Grandmaster clock configuration.
Identity	The hardware address of the Grandmaster clock.
Priority1	The priority1 preference value of the PTP clock; the priority1 clock is considered first during clock selection.
Priority2	The priority2 preference value of the PTP clock; the priority2 clock is considered after all other clock sources during clock selection.
Clock Quality	Summarizes the quality of the Grandmaster clock.
Class	Displays the time and frequency traceability of the grandmaster clock
Accuracy	This field applies only when the Best Master Clock algorithm is in use; indicates the expected accuracy of the master clock were the grandmaster clock.
Offset (log variance)	The offset between the Grandmaster clock and the parent clock.

show ptp clock dataset time-properties

To display a summary of time properties for a Precision Time Protocol (PTP) clock, use the show ptp dataset time-properties command in privileged EXEC mode.

show ptp clock dataset time-properties

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Use this command to verify a PTP clocking configuration.

Examples

The following example shows the output generated by this command:

Router# show ptp clock dataset time-properties 

CLOCK [Boundary Clock, domain 10]

  Current UTC Offset Valid: TRUE

  Current UTC Offset: 10752

  Leap 59: FALSE

  Leap 61: TRUE

  Time Traceable: TRUE

  Frequency Traceable: TRUE

  PTP Timescale: TRUE

  Time Source: Unknown

Table 46 describes significant fields shown in the display.

Table 46 show ptp clock dataset time-properties Field Descriptions 

Field	Description
Current UTC Offset Valid	Indicates whether the current UTC offset is valid.
Current UTC Offset	Offset between the TAI and UTC in seconds.
Leap 59	Indicates whether the last minute of the current UTC day contains 59 seconds.
Leap 61	Indicates whether the last minute of the current UTC day contains 61 seconds.
Time Traceable	Indicates whether the value of the current UTC offset is traceable to a primary reference.
Frequency Traceable	Indicates whether the frequency used to determine the time scale is traceable to a primary reference.
PTP Timescale	Indicates whether the PTP grandmaster clock uses a PTP clock time scale.
Time Source	Time source used by the grandmaster clock.

show ptp clock running

To display a summary of the Precision Time Protocol (PTP) clock status, use the show ptp clock running command in privileged EXEC mode.

show ptp clock running [domain]

Syntax Description

domain

(Optional) Filters output by domain.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Use this command to verify a PTP clocking configuration.

Examples

The following example shows the output generated by this command:

Router# show ptp clock running

PTP Boundary Clock [Domain 1]

State          Ports          Pkts sent      Pkts rcvd      

FREERUN        3              1090           1023      

PORT SUMMARY

Name               Tx Mode      Role         Transport    State        Sessions

MASTER-1           unicast      master       Et0/0        -            5

MASTER-2           mcast        master       Et0/0        -            5

SLAVE              unicast      slave        Et0/0        -            5

PTP Ordinary Clock [Domain 2]

State          Ports          Pkts sent      Pkts rcvd      

HOLDOVER       1              2090           2023      

PORT SUMMARY

Name               Tx Mode      Role         Transport    State        Sessions

MASTER             unicast      master       Et0/0        -            5

Table 47 describes significant fields shown in the display.

Table 47 show ptp clock running Field Descriptions 

Field	Description
State	State of the PTP clock.
Ports	Number of ports assigned to the PTP clock.
Pkts sent	Number of packets sent by the PTP clock.
Pkts rcvd	Number of packets received by the PTP clock.
Name	Name of the PTP clock port.
Tx Mode	Transmission mode of the PTP clock port (unicast or multicast).
Role	PTP role of the clock port (master or slave).
Transport	Physical port assigned to the clock port.
State	State of the clock port.
Sessions	Number of PTP sessions active on the clock port.

show ptp port dataset foreign-master

To display a summary of Precision Time Protocol (PTP) foreign master records, use the show ptp port dataset foreign-master-record command in privileged EXEC mode.

show ptp port dataset foreign-master [domain]

Syntax Description

domain

(Optional) Filters output by domain.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Use this command to verify a PTP clocking configuration.

Examples

The following example shows the output generated by this command.

Router# show ptp dataset foreign-master

PTP FOREIGN MASTER RECORDS

Interface Vlan2

Number of foreign records 1, max foreign records 5

Best foreign record 0

RECORD #0

Foreign master port identity: clock id: 0x0:1E:4A:FF:FF:96:A2:A9

Foreign master port identity: port num: 1

Number of Announce messages: 8

Number of Current Announce messages: 6

Time stamps: 1233935406, 664274927

Table 48 describes significant fields shown in the display.

Table 48 show ptp port dataset foreign-master Field Descriptions 

Field	Description
Interface	Currently foreign-master data is not displayed in the show command.
Number of foreign records	Number of foreign master records in router memory.
max foreign records	Maximum number of foreign records.
Best foreign record	Foreign record with the highest clock quality.
Foreign master port identity: clock id	Hardware address of the foreign master port.
Foreign master port identity: port number	Port number of the foreign master port.
Number of Announce messages	Number of Announce messages received from the foreign master clock.
Number of Current Announce messages	Number of current announcement messages.
Time stamps	Time stamps of current announcement messages.

show ptp port dataset port

To display a summary of Precision Time Protocol (PTP) ports, use the show ptp port dataset port command in privileged EXEC mode.

show ptp dataset port

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Use this command to verify a PTP clocking configuration.

Examples

The following example shows the output generated by this command.

Router# show ptp port dataset port 

PORT [MASTER]

  Clock Identity: 0x49:BD:D1:0:0:0:0:0

  Port Number: 0

  Port State: Unknown

  Min Delay Req Interval (log base 2): 42

  Peer Mean Path Delay: 648518346341351424

  Announce interval (log base 2): 0

  Announce Receipt Timeout: 2

  Sync Interval (log base 2): 0

  Delay Mechanism: End to End

  Peer Delay Request Interval (log base 2): 0

  PTP version: 2

Table 49 describes significant fields shown in the display.

Table 49 show ptp port dataset port Field Descriptions 

Field	Description
Clock Identity	Unique identifier for the clock.
Port Number	Port number on the PTP node.
Port State	State of the PTP port.
Min Delay Req Interval (log base 2)	Time interval permitted between Delay_Req messages.
Peer Mean Path Delay	One way propagation delay on the local port.
Announce interval (log base 2)	Mean interval between PTP announcement messages.
Announce Receipt Timeout	Number of intervals before a PTP announcement times out.
Sync Interval (log base 2)	Mean interval between PTP sync messages.
Delay Mechanism	Mechanism used for measuring propagation delay.
Peer Delay Request Interval (log base 2)	Interval permitted between Peer Delay Request messages.
PTP version	PTP version in use.

shutdown (bridge-domain)

To change the administrative state of a bridge domain from in service to out of service, use the shutdown command in bridge-domain configuration mode. To change the administrative state of a bridge domain from out of service to in service, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Command Default

The bridge domain is in service.

Command Modes

Bridge-domain configuration (config-bdomain)

Command History

Release	Modification
Cisco IOS XE Release 3.2S	This command was introduced.

Usage Guidelines

Use the shutdown command to disable the Layer 2 multipoint bridging service associated with a bridge domain. When a bridge domain is shut down, the state of all service instances bound to it and the bridge domain's corresponding bridge domain interface (BDI) are also shut down.

Examples

The following example shows how to change the administrative state of bridge domain 5 from in service to out of service:

Router(config)# bridge-domain 5 

Router(config-bdomain)# shutdown

snmp-server enable traps ethernet cfm alarm

To enable Ethernet connectivity fault management (CFM) fault alarms (traps), use the snmp-server enable traps ethernet cfm alarm command in global configuration mode. To disable fault alarms, use the no form of this command.

snmp-server enable traps ethernet cfm alarm

no snmp-server enable traps ethernet cfm alarm

Syntax Description

This command has no arguments or keywords.

Command Default

Alarms are disabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.
12.2(54)SE	This command was integrated into Cisco IOS Release 12.2(54)SE.
15.1(1)S	This command was integrated into Cisco IOS Release 15.1(1)S.

Usage Guidelines

Use this command to turn on or turn off CFM fault alarms.

Examples

The following example shows how to enable CFM fault alarms:

Router(config)# snmp-server enable traps ethernet cfm alarm 

snmp-server enable traps ethernet cfm cc

To enable Simple Network Management Protocol (SNMP) trap generation for Ethernet connectivity fault management (CFM) continuity check events, use the snmp-server enable traps ethernet cfm cc command in global configuration mode. To disable SNMP trap generation for Ethernet CFM continuity check events, use the no form of this command.

snmp-server enable traps ethernet cfm cc [config] [cross-connect] [loop] [mep-down] [mep-up]

no snmp-server enable traps ethernet cfm cc [config] [cross-connect] [loop] [mep-down] [mep-up]

Syntax Description

config	(Optional) Generates a trap when a CFM misconfiguration exists in the network.
cross-connect	(Optional) Generates a trap when a cross-connected service exists in the network.
loop	(Optional) Generates a trap when a forwarding loop exists in the network.
mep-down	(Optional) Generates a trap when a device has lost connectivity with a remote MEP or when connectivity from a previously learned remote MEP is restored after interruption.
mep-up	(Optional) Generates a trap when a new remote maintenance endpoint (MEP) has been discovered and learned by the device or when a change occurs in the port state of a previously discovered remote MEP.

Command Default

When no options are configured, all continuity check traps are enabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

The configuration error trap (cEtherCfmCcConfigError) is triggered when a device receives a CCM that has the same MPID as a locally configured MEP but a different source MAC Address than its own. The configuration error trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of local MEP that has the same ID as that received in the CCM.

•Name of the interface on which the MEP above is configured.

•MAC Address of the remote device sending the CCM.

The cross-connect service trap (cEtherCfmCcCrossconnect) is generated when a device receives a continuity check message (CCM) whose service ID is different from what is locally configured on the device for the given service VLAN (S-VLAN). This mismatch indicates that there could be a cross-connected service in the network. The trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of remote MEP causing the alarm to be raised.

•MAC address of remote MEP causing the alarm to be raised.

•Service ID reported by the remote MEP.

The loop trap (cEtherCfmCcLoop) is generated when a device receives a CCM that has the same source MAC Address and MPID as its own, thereby indicating that the device is receiving its own CCMs and that a forwarding loop exists in the network. The loop trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of the MEP originating the CCM.

•Name of the interface on which the MEP above is configured.

The mep-down trap (cEtherCfmCcMepDown) notifies the NMS that the device has lost connectivity with a remote MEP. This trap also serves as a clear for Loop, Config, Cross-Connect and Unknown-MEP events.

The mep-down trap is generated in the following cases:

•A valid CCM with a zero hold-time is received from a remote MEP, and the device either has a valid (non-expired) CCDB entry for that MEP or does not have any CCDB entry. In other words, the trap is not generated for an already expired CCDB entry. This trigger has the event code "lastGasp."

•An entry for a remote MEP in the CCDB expires and is archived. This trigger has the event code "timeout."

•A previous configuration error trap is cleared. This trigger has the event code "configClear."

•A previous loop trap is cleared. This trigger has the event code "loopClear."

•A previous Crossconnect trap is cleared. This trigger has the event code "xconnectClear."

•A previous unknown trap is cleared. This trigger has the event code "unknownClear."

The mep-down trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•A count of the local MEPs on the same domain and S-VLAN as the remote MEP that are affected by the event.

•A count of the different interfaces on which the local MEPs above are configured.

•MPID of the remote MEP that is being reported down.

•MAC address of the remote MEP that is being reported down.

•Event code indicating one of the following: lastGasp, timeout, configClear, loopClear, xconnectClear, unknownClear.

The mep-up trap (cEtherCfmCcMepUp) serves three functions. One function is to notify the network management system (NMS) that a new MEP has been discovered and learned by the device. The second function is that the trap notifies the NMS that there is a change in the port-state of a previously discovered remote MEP. The third is to notify the NMS when connectivity from a previously discovered MEP is restored after interruption.

Mep-up traps are suppressed while cross-check is operational because the cross-check traps more efficiently convey the status of the service.

The mep-up trap is generated in the following cases:

•A valid CCM with a non-zero hold-time is received from a remote MEP for the first time, and hence an entry is created for that MEP in the continuity check database (CCDB). This trigger has the event code "new."

•A valid CCM with a non-zero hold-time is received from a remote MEP for which the device has an expired entry in the CCDB (that is, the device has an entry for that remote MEP in the archived DB). This trigger has the event code "returning."

•A valid CCM with a non-zero hold-time is received from a remote MEP for which the device has a valid entry in the CCDB and the port-state indicated in the CCM is different from what is cached in the CCDB. This trigger has the event code "portState"

The mep-up trap includes the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•The MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•A count of the local MEPs on the same domain and S-VLAN as the remote MEP that are affected by the event.

•A count of the different interfaces on which the local MEPs above are configured.

•MPID of the remote MEP that is being reported up.

•MAC address of the remote MEP that is being reported up.

•Event code indicating one of the following: new MEP, returning MEP, or port-state change.

•Port state of remote MEP.

Examples

The following example shows how to enable SNMP trap generation for Ethernet CFM continuity checks when a new remote MEP is discovered and learned by the device:

Router(config)# snmp-server enable traps ethernet cfm cc mep-up

snmp-server enable traps ethernet cfm crosscheck

To enable Simple Network Management Protocol (SNMP) trap generation for Ethernet connectivity fault management (CFM) continuity check events, in relation to the cross-check operation between statically configured maintenance endpoints (MEPs) and those learned via continuity check messages (CCMs), use the snmp-server enable traps ethernet cfm crosscheck command in global configuration mode. To disable SNMP trap generation for these continuity check events, use the no form of this command.

snmp-server enable traps ethernet cfm crosscheck [mep-missing] [mep-unknown] [service-up]

no snmp-server enable traps ethernet cfm crosscheck [mep-missing] [mep-unknown] [service-up]

Syntax Description

mep-missing	(Optional) Generates a trap when the cross-check enable timer expires and no CCMs were received from an expected (configured) MEP. One trap is generated per remote MEP.
mep-unknown	(Optional) Generates a trap when an unexpected (unconfigured) MEP comes up. One trap is generated per remote MEP.
service-up	(Optional) Generates a trap when all remote MEPs belonging to a service instance come up.

Command Default

This command is disabled.

When no options are configured, all continuity check event traps are enabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SXI2	This command was integrated into Cisco IOS Release 12.2(33)SXI2.

Usage Guidelines

For this class of traps to function, cross-check must be enabled on the device. Otherwise, none of these traps will be generated, even if they are configured.

The mep-missing trap (cEtherCfmXCheckMissing) notifies the network management system (NMS) that the device did not receive any CCMs from a remote MEP that it was expecting to be part of the service instance.

The mep-missing trap is generated in the following case:

•After enabling cross-check (ethernet cfm mep crosscheck enable), the device waits for the cross-check-start timeout value specified (ethernet cfm mep crosscheck enable-timeout). When the timeout period has elapsed, the device will cross-check the list of remote MEPs it has learned via CCMs against the static list that has been configured (mep crosscheck mpid vlan). For each remote MEP that is configured in the static list and for which the device has not received a CCM, a mep-missing trap is generated.The mep-missing trap has the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of the remote MEP that is being reported missing.

•MAC address of the remote MEP that is being reported missing.

The mep-unknown trap (cEtherCfmXCheckUnknown) notifies the NMS that the device received CCMs from a remote MEP that it was not expecting to be part of the service instance.

The mep-unknown trap is generated in the following case:

•After cross-check is in an operational state, the device dynamically examines the list of statically configured remote MEPs against what it learns from CCMs. This occurs after cross-check is enabled and the timer has expired. When the device receives a CCM with non-zero hold time from a remote MEP that does not exist in the static list, the device raises a mep-unknown trap.

The mep-unknown trap has the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

•MPID of the remote MEP that is being reported unknown.

•MAC address of the remote MEP that is being reported unknown.

The service-up trap (cEtherCfmXCheckServiceUp) notifies the NMS that the device received CCMs from all remote MEPs within a given service instance.

The service-up trap is generated in the following case:

•When the device receives CCMs from all remote statically configured MEPs before the expiration of the crosscheck enable-timeout period.

The service-up trap has the following fields:

•Service ID designating the customer service instance to which the event belongs, as configured on the device reporting the event.

•MAC address of the device reporting the event. This is typically the Bridge Brain MAC address.

Examples

The following example shows how to enable SNMP trap generation for Ethernet CFM continuity check events when an unexpected (unconfigured) MEP comes up:

Router (config)# snmp-server enable traps ethernet cfm crosscheck mep-unknown

Related Commands

Command	Description
ethernet cfm mep crosscheck enable	Enables cross checking between the list of configured remote MEPs of a domain and MEPs learned through CCMs.
mep crosscheck mpid vlan	Statically defines a remote MEP within a maintenance domain.

snmp-server enable traps ethernet evc

To enable Simple Network Management Protocol (SNMP) Ethernet virtual circuit (EVC) traps, use the snmp-server enable traps ethernet evc command in global configuration mode. To disable SNMP EVC traps, use the no form of this command.

snmp-server enable traps ethernet evc [create] [delete] [status]

no snmp-server enable traps ethernet evc

Syntax Description

create	(Optional) Enables SNMP EVC create traps.
delete	(Optional) Enables SNMP EVC delete traps.
status	(Optional) Enables SNMP EVC status traps.

Command Default

Trap notifications are not sent.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Use this command to turn on or turn off SNMP EVC traps.

Examples

The following example shows how to enable SNMP Ethernet EVC traps to be created:

Router# configure terminal

Router(config)# snmp-server enable traps ethernet evc create

Related Commands

snmp-server host traps eve

Enables EVC trap notifications to a specific SNMP host.

snmp-server enable traps ether-oam

To enable Ethernet Operations, Administration, and Maintenance (OAM) MIB traps, use the snmp-server enable traps ether-oam command in global configuration mode. To disable OAM MIB traps, use the no form of this command.

snmp-server enable traps ether-oam

no snmp-server enable traps ether-oam

Syntax Description

This command has no arguments or keywords.

Command Default

OAM traps are disabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

A trap will not be sent if a trap was sent within the last 1 second.

Examples

The following example shows how to enable OAM MIB traps:

Router# configure terminal

Router(config)# snmp-server enable traps ether-oam 

snmp-server host traps evc

To enable Ethernet virtual circuit (EVC) trap notifications to a specific Simple Network Management Protocol (SNMP) host, use the snmp-server host traps evc command in global configuration mode. To disable EVC trap notifications to a specific host, use the no form of this command.

snmp-server host ipaddr traps string evc

no snmp-server host ipaddr traps string

Syntax Description

ipaddr	IPv4 or IPv6 address of the SNMP notification host.
string	SNMPv1 community string, SNMPv2c community string, or SNMPv3 username.

Command Default

EVC trap notifications are not sent to an SNMP host.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Use this command to start or stop sending EVC traps to a specific SNMP host.

Examples

The following example shows how to enable EVC trap notifications to an SNMP host:

Router# configure terminal

Router(config)# snmp-server host 172.17.2.0 traps snmphost01 evc

Related Commands

snmp-server enable traps ethernet evc

Enables SNMP EVC traps.

source template (eoam)

To associate a template to an Ethernet operations, maintenance, and administration (OAM) interface, use the source template (eoam) command in interface configuration mode. To remove the source template association, use the no form of this command.

source template template-name

no source template template-name

Syntax Description

template-name

String that identifies the source template.

Command Default

No source template is configured.

Command Modes

Interface configuration (config-if)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

When this command is used, the interface inherits all the configurations in the template. A benefit of using a source template is that it helps reduce the overall configuration size by grouping repeating commands.

Examples

The following example shows how to create a source template named oam on OAM interface Ethernet 0/1:

Router(config)# interface ethernet 0/1

Router(config-if)# source template oam

Related Commands

template (eoam)

Configures a template for use on Ethernet OAM interfaces and places the device in configuration template mode.

status decoupled

To enable decoupled mode so that the state of the Attachment Circuits (ACs) on the user-facing Provider Edge (uPE) device is decoupled from the state of the pseudowire (PW) connections, use the status decoupled command in virtual forwarding interface (VFI) configuration mode or pseudowire (PW) class configuration mode. To disable the decoupled mode, use the no form of this command.

status decoupled

no status decoupled

Syntax Description

This command has no arguments or keywords.

Command Default

This command is disabled by default, so coupled mode is active.

Command Modes

VFI configuration (config-vfi)
Pseudowire class configuration (config-pw)

Command History

Release	Modification
12.2(33)SRE	This command was introduced.

Usage Guidelines

Coupled and decoupled modes are defined as follows:

•Coupled Mode—When at least one AC in VFI changes state to Active, all PWs in VFI advertise Active. When all ACs in VFI change state to Standby, all PWs in VFI will advertise Standby mode.

•Decoupled Mode—All the PWs in the VFI are always active, and the AC state is independent of the PW state. It can be enabled if the peer does not support PW preferential forwarding (standby) circuit status. This provides lower switchover time, at the cost of extra flooding/multicast that will be dropped on the peer PE with standby ACs.

The Multi-chassis Link Aggregation Control Protocol (mLACP) controls the state of the ACs.

Examples

This example shows status decoupled enabled in pseudowire class configuration mode:

pseudowire-class mpls-dhd

 encapsulation mpls

 status peer topology dual-homed

 status decoupled

Related Commands

Command	Description
l2 vfi manual	Enters VFI configuration mode and establishes a Layer 2 virtual forwarding interface between two separate networks.
pseudowire-class	Specifies the name of a Layer 2 pseudowire class and enters pseudowire class configuration mode.

status peer topology dual-homed

To enable the reflection of the Attachment Circuit (AC) status onto both the primary and secondary pseudowire (PW) connections, use the status peer topology dual-homed command in pseudowire class configuration mode. To disable this reflection status, use the no form of this command.

status peer topology dual-homed

no status peer topology dual-homed

Syntax Description

This command has no arguments or keywords.

Command Default

If this command is not entered, the reflection of AC status onto the primary and secondary PW connections does not occur.

Command Modes

Pseudowire class configuration mode (config-pw)

Command History

Release	Modification
12.2(33)SRE	This command was introduced.

Usage Guidelines

The status peer topology dual-homed command must be entered if the peer Provider Edge (PE) devices are connected to a dual-homed device.

Examples

This example shows how to enter pseudowire-class configuration mode and configure the status peer topology for dual-homed operation:

pseudowire-class mpls-dhd

 encapsulation mpls

 status peer topology dual-homed

Related Commands

Command	Description
pseudowire-class	Puts the CLI in pseudowire-class configuration mode.

sync interval

To specify an interval for the device to exchange Precision Time Protocol synchronization messages, use the sync interval command in PTP clock port configuration mode. To disable a sync interval configuration, use the no form of this command.

sync interval interval-value

no sync interval interval-value

Syntax Description

interval-value

Value of the interval at which the router sends sync packets. The intervals are set using log base 2 values, as follows: •4—1 packet every 16 seconds •3—1 packet every 8 seconds •2—1 packet every 4 seconds •1—1 packet every 2 seconds •0—1 packet every second •-1—1 packet every 1/2 second, or 2 packets per second •-2—1 packet every 1/4 second, or 4 packets per second •-3—1 packet every 1/8 second, or 8 packets per second •-4—1 packet every 1/16 seconds, or 16 packets per second •-5—1 packet every 1/32 seconds, or 32 packets per second •-6—1 packet every 1/64 seconds, or 64 packets per second The recommended value is -6.

Command Default

The default value is 1.

Command Modes

PTP clock port configuration (config-ptp-port)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

The recommended value is -6.

Examples

The following example shows how to configure the PTP sync interval:

Router# configure terminal

Router(config)# ptp clock ordinary domain 0

Router(config-ptp-clk)# clock-port slave slaveport

Router(config-ptp-port)# sync interval -4

Router(config-ptp-port)# end

Related Commands

Command	Description
clock-port	Specifies the mode of a PTP clock port.

template (eoam)

To configure a template for use on Ethernet operations, maintenance, and administration (OAM) interfaces and enter configuration template mode, use the template (eoam) command in global configuration mode. To remove the template, use the no form of this command.

template template-name

no template template-name

Syntax Description

template-name

String that identifies the template.

Command Default

No templates are configured.

Command Modes

Global configuration (config)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(15)T	This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

This command groups parameters that can be applied (bound) to one or more interfaces that share the same OAM characteristics. A benefit of using the template (eoam) command is that it helps reduce the overall configuration size by grouping repeating commands and streamlines Ethernet OAM interface configuration.

More than one template can be configured but only one template can be associated with a single Ethernet OAM interface. Commands defined in a template may be overridden by explicitly configuring those commands on the interface in interface configuration mode.

Examples

The following example shows how to create an OAM template named oam and enter configuration template mode:

Router(config)# template oam

Router(config-template)#

Related Commands

source template (eoam)

Associates a template to an Ethernet OAM interface.

tod

To configure the time of day message format used by the 1PPS interface use the tod command in global configuration mode. To remove a time of day configuration, use the no form of this command.

tod slot/bay {iso8601 | ubx | nmea | cisco | ntp} [delay delay-amount]

no tod slot/bay {iso8601 | ubx | nmea | cisco | ntp} [delay delay-amount]

Syntax Description

slot	Slot of the 1PPS interface.
bay	Bay of the 1PPS interface.
iso8601	Specifies ISO 8601 time of day format.
ubx	Specifies UBX time of day format.
nmea	Specifies NMEA time of day format.
cisco	Specifies Cisco time of day format.
ntp	Specifies NTP time of day format.
delay	(Optional) Specifies a delay between the 1PPS message and the time of day message.
delay-amount	(Optional) Amount of delay between the 1PPS message and the time of day message, in milliseconds. The range is from 1 to 999.

Command Default

No default behavior or values.

Command Modes

PTP clock configuration (config-ptp-clk)

Command History

Release	Modification
12.2(31)SB2	This command was introduced.

Usage Guidelines

This command only applies to platforms that have 1PPS ports.

Examples

The following example shows how to configure a time of day value:

Router# configure terminal

Router(config)# ptp clock ordinary domain 0

Router(config-ptp-clk)# tod 3/0 ntp

Router(config-ptp-clk)# end

Related Commands

Command	Description
input	Enables PTP input clocking using the 1.544 Mhz, 2.048 Mhz, or 10 Mhz timing interface or phase using the 1PPS or RS-422 interface.
output	Enables output of time of day messages using the 1PPS interface.

traceroute ethernet

To send Ethernet connectivity fault management (CFM) traceroute messages to a destination maintenance endpoint (MEP), use the traceroute ethernet command in privileged EXEC mode. This command does not have a no form.

traceroute ethernet {mac-address | mpid mpid} {domain domain-name {evc evc-name | port | vlan vlan-id}} [cos value] [fdb-only | source mpid]

Syntax Description

Syntax DescriptionCommand Syntax]

mac-address	MAC address of a remote MEP in the format abcd.abcd.abcd.
mpid	Specifies a destination MEP.
mpid	Integer from 1 to 8191 that identifies the MEP.
domain	Specifies the domain in which the destination MEP resides.
domain-name	String of a maximum of 154 characters that identifies the domain.
evc	Specifies an Ethernet virtual circuit (EVC).
evc-name	String that identifies the EVC.
port	Specifies a DOWN service with no VLAN association (untagged).
vlan	Specifies a VLAN.
vlan-id	Integer from 1 to 4094 that identifies the VLAN.
cos	(Optional) Specifies a class of service (CoS).
value	(Optional) Integer from 0 to 7 that identifies the CoS.
fdb-only	(Optional) Specifies the forwarding database (FDB) table.
source	(Optional) Specifies a source MEP.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SXI2	This command was introduced.
12.2(33)SRE	This command was modified. Support for the evc keyword was added in Cisco IOS Release 12.2(33)SRE.

Usage Guidelines

If a CoS is not configured, the default is the highest priority allowed for the egress interface.

FDB is another term for the L2 forwarding table. When the fdb-only option is configured, only MAC addresses learned in a bridge's FDB (not information saved in the maintenance intermediate point [MIP] continuity check database [CCDB]) are used to determine the egress port.

The destination can be either a MEP or a MIP. If the destination is a MIP, the FDB must have a MAC address entry for that MIP; that is, the FDB has learned the MIP's MAC address via Linktrace responses.

For a bridge domain-VLAN service, the VLAN ID can be used to initiate traceroute.

On the Cisco Catalyst 6500 series switch, an FDB configuration will work only if the origination MEP is a down MEP. Also, for a MEP to clear the Alarm Indication Signal (AIS) defect condition, there should be no corresponding entry in the error database. For example, if you change the remote MEP from an UP MEP to a DOWN MEP, the local entry will time out and enter the AIS defect condition. The database starts receiving a new CC entry based on the newly configured DOWN MEP, but the local AIS defect is not yet cleared. It will remain in the AIS state until either the archive hold time expires or you issue the clear ethernet cfm errors command.

The following example shows a traceroute ethernet command and output:

Router# traceroute ethernet mpid 401 domain Domain_L5 vlan 9

Type escape sequence to abort. TTL 64. Linktrace Timeout is 5 seconds

Tracing the route to aabb.cc03.bb99 on Domain Domain_L5, Level 5, vlan 9

Traceroute sent via Ethernet0/0.9, path found via MPDB

B = Intermediary Bridge

! = Target Destination

* = Per hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingr Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egr Action   Previous Hop     

--------------------------------------------------------------------------------

! 1                    aabb.cc03.bb99                           RlyHit:MEP     

                       Not Forwarded                            aabb.cc03.b999

Related Commands

Command	Description
clear ethernet cfm errors	Removes continuity check error conditions from the error database.
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
show ethernet traceroute-cache	Displays the contents of the traceroute cache.

traceroute ethernet evc

To send Ethernet connectivity fault management (CFM) traceroute messages to a destination MAC address, use the traceroute ethernet evc command in privileged EXEC mode.

traceroute ethernet mac-address {domain domain-name | level level-id} evc evc-name

Syntax Description

mac-address	MAC address of a remote maintenance endpoint (MEP) in the format abcd.abcd.abcd.
domain	Identifies the domain in which the destination MEP resides.
domain-name	String of a maximum of 154 characters that identifies the domain.
level	Indicates the maintenance level where the device with the specified MAC address is located.
level-id	Integer from 0 to 7 that identifies the maintenance level.
evc-name	String that identifies the Ethernet virtual circuit (EVC) name.

Command Default

Sends an Ethernet CFM traceroute message to a specified MAC address.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRD	This command was introduced.

Usage Guidelines

Traceroute messages can be issued only to MEPs. Before you issue the traceroute ethernet evc command, you should have a MEP configured for the same EVC and domain.

Examples

The following example shows how to send an Ethernet CFM traceroute message to MAC address aabb.cc00.1010 in maintenance level 4 on evc_100:

Router# traceroute ethernet aabb.cc00.1010 level 4 evc evc_100

Type escape sequence to abort. TTL 255. Per-Hop Timeout is 10 seconds

Tracing the route to aabb.cc00.1010 on Domain PROVIDER, Level 4, evc evc_100

Traceroute sent via Ethernet6/0

B = Intermediary Bridge

! = Target Destination

* = Per Hop Timeout

--------------------------------------------------------------------------------

                             MAC      Ingress      Ingress Action  Relay Action    

  Hops   Host             Forwarded   Egress       Egress Action   Next Hop        

--------------------------------------------------------------------------------

B 1   PE               aabb.cc00.1011 Et6/0        IngOk        RlyCCDB        

                       Forwarded      Et1/0.100    EgrOK        CE1            

! 2   CE1              aabb.cc00.1010 Et1/0.100    IngOk        RlyNone        

                       Not Forwarded 

Related Commands

Command	Description
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
show ethernet traceroute-cache	Displays the contents of the traceroute cache.
traceroute-ethernet vlan	Sends Ethernet CFM traceroute messages to a destination MAC address.

traceroute ethernet vlan

To send Ethernet connectivity fault management (CFM) traceroute messages to a destination MAC address, use the traceroute ethernet vlan command in privileged EXEC mode.

traceroute ethernet mac-address {domain domain-name | level level-id} vlan vlan-id

Syntax Description

Syntax DescriptionCommand Syntax]

mac-address	MAC address of a remote MEP in the format abcd.abcd.abcd.
domain	Identifies the domain in which the destination MEP resides.
domain-name	String of a maximum of 154 characters that identifies the domain.
level	Indicates the maintenance level where the device with the specified MAC address is located.
level-id	Integer from 0 to 7 that identifies the maintenance level.
vlan-id	Integer from 1 to 4094 that identifies the VLAN.

Command Default

Sends an Ethernet CFM traceroute message to a specified MAC address.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SRA	This command was introduced.
12.4(11)T	This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH	This command was integrated into Cisco IOS Release 12.2(33)SXH.

Usage Guidelines

Traceroute messages can be issued only to maintenance endpoints (MEPs). Before you issue the traceroute ethernet vlan command, you should have a MEP configured for the same VLAN and domain.

Examples

The following example shows how to send an Ethernet CFM traceroute message to MAC address bc12.cc12.dc12 in maintenance level 3, VLAN ID 2550:

Router# traceroute ethernet bc12.cc12.dc12 level 3 vlan 2550

Type escape sequence to abort. TTL 255. Per-Hop Timeout is 10 seconds

Tracing the route to aabb.cc00.0400 on Domain DOMAIN_OPERATOR_L5_1, Level 5, vlan 7

Traceroute sent via Ethernet1/0.6

--------------------------------------------------------------------------------

                             MAC      Ingress Ingress Action    Relay Action    

  Hops   Host             Forwarded   Egress  Egress Action     Next Hop        

--------------------------------------------------------------------------------

B 1   denver           aabb.cc00.0200                           RlyCCDB        

                       Forwarded      Et0/0   EgrOK             columbus       

! 2   boston           aabb.cc00.0400                           RlyNone        

                       Not Forwarded 

Related Commands

Command	Description
clear ethernet cfm traceroute-cache	Removes the contents of the traceroute cache.
ethernet cfm traceroute-cache	Enables caching of Ethernet CFM data learned through traceroute messages.
show ethernet traceroute-cache	Displays the contents of the traceroute cache.

transport ipv4 (PTP)

To specify the IP version, transmission mode, and interface that a Precision Time Protocol clock port uses to exchange timing packets, use the transport ipv4 command in PTP clock port configuration mode. To remove a transport configuration, use the no form of this command.

transport ipv4 {unicast | multicast | multicast-mix} interface interface-type interface-number [negotiation]

no transport ipv4 {unicast | multicast | multicast-mix} interface interface-type interface-number [negotiation]

Syntax Description

unicast	Configures the clock port to exchange timing packets in unicast mode.
multicast	Configures the clock port to exchange timing packets in multicast mode.
multicast-mix	Configures the clock port to exchange timing packets in multicast-unicast communication mode. In multicast-unicast mode, the clock port sends initial Announce and Sync messages as multicast; if a slave device responds with a unicast message, the clock port sends the Delay-Resp message as unicast.
interface	Specifies an interface on the device.
interface-type	The type of the interface.
interface-number	The number of the interface.
negotiation	(Optional) Enables dynamic discovery of slave devices and their preferred format for sync interval and announce interval messages.

Command Default

No default behavior or values.

Command Modes

PTP clock port configuration (config-ptp-port)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

You can configure different transport values for each PTP clock port.

Examples

The following example shows how to use the transport ipv4 command:

Router# configure terminal

Router(config)# ptp clock ordinary domain 0

Router(config-ptp-clk)# clock-port masterport master

Router(config-ptp-port)# transport ipv4 unicast interface top5/2/2

Router(config-ptp-port)# end

Related Commands

Command	Description
clock-port	Specifies the mode of a PTP clock port.

uni count

To set the user-network interface (UNI) count for an Ethernet virtual connection (EVC), use the uni count command in EVC configuration mode. To return to the default setting, use the no form of this command.

uni count value [multipoint]

no uni count

Syntax Description

value	Integer in the range of 2 to 1024 that is the number of UNIs in the EVC. The default is 2.
multipoint	(Optional) Indicates point-to-multipoint service. This option is available only with a uni count value of 2.

Command Default

The UNI count defaults to 2 and the service defaults to point-to-point service.

Command Modes

EVC configuration (config-evc)

Command History

Release	Modification
12.2(25)SEG	This command was introduced.
12.2(33)SRB	This command was implemented on the Cisco 7600 series routers.

Usage Guidelines

The UNI count determines the type of service in the EVC.

•A UNI count value of 1 or 2—The service defaults to point-to-point service.

•A UNI value of 2—You can leave the service at the default or you can configure point-to-multipoint service by entering the multipoint keyword.

•A UNI value of 3 or greater—The service is point-to-multipoint.

You should know the correct number of maintenance end points (MEPs) in the domain. If you enter a UNI count value greater than the number of endpoints, the UNI status shows as partially active even if all endpoints are up. If you enter a UNI count less than the number of endpoints, UNI status shows as active, even if all endpoints are not up.

---

Caution Configuring a UNI count does not prevent you from configuring more endpoints than the configured number of UNIs. For example, if you configure a UNI count of 5, but you create 10 MEPs, any 5 MEPs in the domain can go down without the status changing to partially active.

---

Examples

The following example shows how to set a UNI count of 2 with point-to-multipoint service:

Router(config)# ethernet evc test1

Router(config-evc)# uni count 2 multipoint

Related Commands

Command	Description
ethernet evc	Defines an EVC and enters EVC configuration mode.

weight (srvs instance)

To assign a weight to an Ethernet service instance, use the weight command in service instance configuration mode. To remove the weight assignment, use the no form of this command.

weight weight

no weight

Syntax Description

weight

Integer from 1 to 10000 that is the weight value. The default is 1.

Command Default

If a specific weight is not configured, the Ethernet service instance inherits the default weight of 1.

Command Modes

Service instance configuration (config-if-srv)

Command History

Release	Modification
15.0(1)S	This command was introduced.

Usage Guidelines

Performing this command more than once on the same Ethernet service instance overwrites the previously configured weight. To allow for out-of-order configuration, weights may be configured on Ethernet service instances before weighted load balancing is configured on the port channel.

The weight chosen for an Ethernet service instance should be based on the expected amount of traffic to egress the service instance relative to other Ethernet service instances. For example, an Ethernet service instance configured with a weight of 8 is expected to transmit twice the traffic of an Ethernet service instance configured with a weight of 4. The configured weights allow the load-balancing algorithm to more evenly distribute the service instances across the available member links. The weight command is optional and if it is not configured, the Ethernet service instance inherits the default weight.

Examples

The following example shows how to assign a weight of 250 to Ethernet service instance 100:

Router(config)# interface port-channel10

Router(config-if)# port-channel load-balance weighted link all

Router(config-if)# service instance 100 ethernet

Router(config-if-srv)# weight 250

Related Commands

Command	Description
port-channel load-balance (interface)	Configures a member link for load balancing, a default Ethernet service instance weight, or weighted load balancing on port-channel member links.