-
Cisco IOS Switching Services Command Reference, Release 12.1
-
About the Cisco IOS Software Documentation
-
Using Cisco IOS Software
-
Switching Commands: Introduction
-
Commands: address-family through ip cef
-
Commands: ip cef accounting through lane fssrp
-
Commands: lane global-lecs-address through name elan-id
-
Commands: name local-seg-id through show interface stats
-
Commands: show interface XTagATM through show ip mds summary
-
Commands: show ip mroute through show lane client
-
Commands: show lane config through show mpoa client cache
-
Commands: show mpoa client statistics through show tag-switching tdp bindings
-
Commands: show tag-switching tdp discovery through tunnel tsp-hop
-
Table Of Contents
set ip next-hop verify-availability
show controllers vsi control-interface
show controllers vsi descriptor
name local-seg-id
To specify or replace the ring number of the emulated LAN in the configuration server's configuration database, use the name local-seg-id command in database configuration mode. To remove the ring number from the database, use the no form of this command.
name elan-name local-seg-id segment-number
no name elan-name local-seg-id segment-number
Syntax Description
elan-name
Name of the emulated LAN. The maximum length of the name is 32 characters.
segment-number
Segment number to be assigned to the emulated LAN. The number ranges from 1 to 4095.
Defaults
No emulated LAN name or segment number is provided.
Command Modes
Database configuration
Command History
Usage Guidelines
This command is ordinarily used for Token Ring LANE.
The same LANE ring number cannot be assigned to more than one emulated LAN.
The no form of this command deletes the relationships.
Examples
The following example specifies a ring number of 1024 for the emulated LAN red:
name red local-seg-id 1024Related Commands
name preempt
To set the ELAN preempt, use the name preempt command in LANE database configuration mode. To disable preemption, use the no form of this command.
name elan-name preempt
no name elan-name preempt
Syntax Description
Defaults
Preemption is off by default.
Command Modes
LANE database configuration
Command History
Usage Guidelines
In prior releases, when the primary LES failed, Cisco SSRP protocol switched over to a secondary LES. But when a LES that is ranked higher in the list came back up, the SSRP protocol switched the active LES to the new LES, which had a higher priority. This forced the network to flap multiple times. In this release, we have prevented the network flapping by staying with the currently active master LES regardless of the priority. If a higher priority LES comes back online, SSRP will not switch to that LES.
LES preemption is off by default. The first LES that comes on becomes the master. Users can revert to the old behavior (of switching to the higher-priority LES all the time) by specifying the name elan-name preempt command in the LECS database.
Examples
The following example sets the ELAN preempt for the ELAN named MYELAN:
name MYELAN preemptname server-atm-address
To specify or replace the ATM address of the LANE server for the emulated LAN in the configuration server's configuration database, use the name server-atm-address command in database configuration mode. To remove it from the database, use the no form of this command.
name elan-name server-atm-address atm-address [restricted | un-restricted] [index number]
no name elan-name server-atm-address atm-address [restricted | un-restricted] [index number]
Syntax Description
Defaults
No emulated LAN name or server ATM address is provided.
Command Modes
Database configuration
Command History
11.0
This command was introduced.
11.2
The following keywords were added:
•
un-restricted
•
Usage Guidelines
Emulated LAN names must be unique within one named LANE configuration database.
Specifying an existing emulated LAN name with a new LANE server ATM address adds the LANE server ATM address for that emulated LAN for redundant server operation or simple LANE service replication. This command can be used multiple times.
The no form of this command deletes the relationships.
Examples
The following example configures the example3 database with two restricted and one unrestricted emulated LANs. The clients that can be assigned to the eng and mkt emulated LANs are specified using the client-atm-address commands. All other clients are assigned to the man emulated LAN.
lane database example3name eng server-atm-address 39.000001415555121101020304.0800.200c.1001.02 restrictedname man server-atm-address 39.000001415555121101020304.0800.200c.1001.01name mkt server-atm-address 39.000001415555121101020304.0800.200c.4001.01 restrictedclient-atm-address 39.000001415555121101020304.0800.200c.1000.02 name engclient-atm-address 39.0000001415555121101020304.0800.200c.2000.02 name engclient-atm-address 39.000001415555121101020304.0800.200c.3000.02 name mktclient-atm-address 39.000001415555121101020304.0800.200c.4000.01 name mktdefault-name manRelated Commands
neighbor activate
To enable the exchange of information with a neighboring router, use the neighbor activate command in address family submode or router configuration mode. To disable the exchange of an address with a neighboring router, use the no form of this command.
neighbor {ip-address| peer-group-name} activate
no neighbor {ip-address| peer-group-name} activate
Syntax Description
Defaults
The exchange of addresses with neighbors is enabled by default for the IPv4 address family. You can disable IPv4 address exchange using the general command no default bgp ipv4 activate, or you can disable it for a particular neighbor using the no form of this command.
For all other address families, address exchange is disabled by default. You can explicitly activate the default command using the appropriate address family submode.
Command Modes
Address family submode
Router configuration
Command History
Usage Guidelines
Use this command to enable or disable the exchange of addresses with a neighboring router.
Examples
The following example activates advertisement of NLRI for address family VPN IPv4 for all neighbors in the BGP peer group PEPEER and for the neighbor 144.0.0.44:
address-family vpnv4neighbor PEPEER activateneighbor 144.0.0.44 activateexit-address-familyRelated Commands
Enters the address family submode for configuring routing protocols, such as BGP, RIP, and static routing.
exit-address-family
Exits from the address family submode.
neighbor allowas-in
To configure PE routers to allow readvertisement of all prefixes containing duplicate ASNs, use the neighbor allowas-in command in router configuration mode. To disable the readvertisement of a PE router's ASN, use the no form of this command.
neighbor ip-address allowas-in [number]
no neighbor ip-address allowas-in [number]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Router configuration
Command History
12.0(7)T
This command was introduced.
12.1
This command was integrated into Cicso IOS Release 12.1.
Usage Guidelines
In a hub and spoke configuration, a PE router readvertises all prefixes containing duplicate autonomous system numbers. Use the neighbor allowas-in command to configure two VRFs on each PE router to receive and readvertise prefixes:
•
•
You control the number of times an ASN is advertised by specifying a number from 1 to 10.
Examples
In the following example, the PE router with ASN 100 is configured to allow prefixes from the VRF address family VPN IPv4 vrf1. The neighboring PE router with the IP address 192.168.255.255 is set to be readvertised to other PE routers with the same ASN six times:
router bgp 100address-family ipv4 vrf vrf1neighbor 192.168.255.255 allowas-in 6Related Commands
address-family
Enters the address family submode used to configure routing protocols including BGP, OSPF, RIP, and static routing.
neighbor as-override
To configure a PE router to override the ASN of a site with the ASN of a provider, use the neighbor as-override command in router configuration mode. To remove VPN IPv4 prefixes from a specified router, use the no form of this command.
neighbor ip-address as-override
no neighbor ip-address as-override
Syntax Description
Defaults
No default behavior or values.
Command Modes
Router configuration
Command History
Usage Guidelines
This command is used in conjunction with the site-of-origin feature, identifying the site where a route originated, and preventing routing loops between routers within a VPN.
Examples
The following example shows how to configure a router to override the ASN of a site with the ASN of a provider:router bgp 100neighbor 192.168.255.255 remote-as 109neighbor 192.168.255.255 update-source loopback0address-family ipv4 vrf vpn1neighbor 192.168.255.255 activateneighbor 192.168.255.255 as-overrideRelated Commands
network-id
To specify the network ID of an MPS, use the network-id command in MPS configuration mode. To revert to the default value (default value for network-id is 1), use the no form of this command.
network-id id
no network-id
Syntax Description
Defaults
The default value for network-id is 1.
Command Modes
MPS configuration
Command History
Usage Guidelines
Specifies the network ID of this MPS. This value is used in a very similar way the NHRP network ID is used. It is for partitioning NBMA clouds artificially by administration.
Examples
The following example sets the network ID to 5:
network-id 5next-address
To specify the next IP address in the explicit path, use the next-address command in IP explicit path subcommand mode.
next-address A.B.C.D
Syntax Description
Defaults
No default behavior or values.
Command Modes
IP explicit path subcommand
Command History
Examples
The following commands assign the number 60 to the IP explicit path, set the state of the path to be enabled, and specify 3.3.27.3 as the next IP address in the list of IP addresses.
configure terminalEnter configuration commands, one per line. End with CNTL/Z.mpls traffic-eng tunnelsip explicit-path identifier 60 enablenext-address 3.3.27.3Explicit Path identifier 60:1: next-address 3.3.27.3Related Commands
rd
To create routing and forwarding tables for a VRF, use the rd command in VRF submode.
rd route-distinguisher
Syntax Description
Defaults
There is no default. An RD must be configured for a VRF to be functional.
Command Modes
VRF submode
Command History
Usage Guidelines
A route distinguisher (RD) creates routing and forwarding tables and specifies the default route distinguisher for a VPN. The RD is added to the beginning of the customer's IPv4 prefixes to change them into globally unique VPN-IPv4 prefixes.
Either RD is either an ASN-relative, in which case it is composed of an autonomous system number and an arbitrary number, or it is IP-address-relative, in which case it is composed of an IP address and an arbitrary number.
You can enter an RD in either of these formats:
16-bit AS number: your 32-bit number
For example, 101:332-bit IP address: your 16-bit number
For example, 192.168.122.15:1Examples
The following example configures a default RD for two VRFs. It illustrates the use of both AS-relative and IP address-relative RDs:
ip vrf vrf_bluerd 100:3ip vrf vrf_red173.13.0.12:200Related Commands
Configures a VRF routing table.
Displays the set of defined VRFs and associated interfaces.
route-target
To create a route-target extended community for a VRF, use the route-target command in VRF submode. To disable the configuration of a route-target community option, use the no form of this command.
route-target {import | export | both} route-target-ext-community
no route-target {import | export | both} route-target-ext-community
Syntax Description
Defaults
There are no defaults. A VRF has no route-target extended community attributes associated with it until specified by the route-target command.
Command Modes
VRF submode
Command History
Usage Guidelines
The route-target command creates lists of import and export route-target extended communities for the specified VRF. Execute the command one time for each target community. Learned routes that carry a specific route-target extended community are imported into all VRFs configured with that extended community as an import route target. Routes learned from a VRF site (for example, by BGP, RIP, or static route configuration) contain export route targets for extended communities configured for the VRF added as route attributes to control the VRFs into which the route is imported.
The route target specifies a target VPN extended community. Like a route-distinguisher, an extended community is composed of either an autonomous system number and an arbitrary number or an IP address and an arbitrary number. You can enter the numbers in either of these formats:
•
For example, 101:3•
For example, 192.168.122.15:1Examples
The following example shows how to configure route-target extended community attributes for a VRF. The result of the command sequence is that VRF vrf_blue has two export extended communities (1000:1 and 1000:2) and two import extended communities (1000:1 and 173.27.0.130:200).
ip vrf vrf_blueroute-target both 1000:1route-target export 1000:2route-target import 173.27.0.130:200Related Commands
ip vrf
Configures a VRF routing table.
import map
Configures an import route map for a VRF.
set ip next-hop verify-availability
To configure policy routing to verify if the next hop(s) of a route map is a CDP neighbor(s) before policy routing to that next hop, use the set ip next-hop verify-availability route-map configuration command.
set ip next-hop verify-availability
Syntax Description
This command has no arguments or keywords.
Command Modes
Route-map configuration
Command History
Usage Guidelines
This command might be used in a case such as you have some traffic traveling via a satellite to a next hop. It might be prudent to verify that the next hop is reachable before trying to policy route to it.
This command has the following restrictions:
•
•
•
•
If the router is policy routing packets to the next hop and the next hop happens to be down, the router will try unsuccessfully to use Address Resolution Protocol (ARP) for the next hop (which is down). This behavior will continue forever.
To prevent this situation from occurring, use this command to configure the router to first verify that the next hop(s) of the route map is the router's CDP neighbor(s) before routing to that next hop.
This command is optional because some media or encapsulations do not support CDP, or it may not be a Cisco device that is sending the router traffic.
If this command is set and the next hop is not a CDP neighbor, the router looks to the subsequent next hop, if there is one. If there is none, the packets simply are not policy routed.
If this command is not set, the packets either are successfully policy routed or remain forever unrouted.
If you want to selectively verify availability of only some next hops, you can configure different route-map entries (under the same route-map name) with different criteria (using access list matching or packet size matching), and use the set ip next-hop verify-availability command selectively.
Examples
The following example configures Policy Routing with CEF. Policy routing is configured to verify that next hop 50.0.0.8 of route map named test is a CDP neighbor before the router tries to policy route to it.
If the first packet is being policy routed via route map test sequence 10, the subsequent packets of the same flow always take the same route map test sequence 10, not route map test sequence 20, because they all match or pass access list 1 check.
ip cefinterface ethernet0/0/1ip route-cache flowip policy route-map testroute-map test permit 10match ip address 1set ip precedence priorityset ip next-hop 50.0.0.8set ip next-hop verify-availabilityroute-map test permit 20set ospf router-id
To set a separate OSPF router ID for each interface or subinterface on a PE router for each directly attached CE router, use the set ospf router-id command in route-map configuration mode.
set ospf router-id
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Route-map configuration
Command History
Usage Guidelines
To use this command, you must enable OSPF and create a routing process.
Examples
In the following example, the PE router IP address 192.168.0.0 is matched against the interface in access-list 1 and set to the OSPF router ID.
router ospf 2 vrfvpn1-site1redistribute bgp 100 metric-type 1 subnetsnetwork 202.0.0.0 0.0.0.255 area 1router bgp 100neighbor 172.19.89. 62 remote-as 100access-list 1 permit 192.168.0.0route-map vpn1-site1-map permit 10match ip address 1set ospf router-idRelated Commands
router ospf
Enables OSPF routing, which places you in the router configuration mode.
set vlan
To group ports into a virtual LAN (VLAN), use the set vlan command in privileged EXEC mode.
set vlan vlan-number module/port
set vlan vlan-number [name name] [type {ethernet | fddi | fddinet | trcrf | trbrf}]
[state {active | suspend}] [said said] [mtu mtu] [ring hex-ring-number]
[decring decimal-ring-number] [bridge bridge-number] [parent vlan-number] [mode {srt |
srb}] [stp {ieee | ibm | auto}] [translation vlan-number] [backupcrf {off | on}]
[aremaxhop hop-count] [stemaxhop hop-count]Syntax Description
Defaults
The default configuration has all switched Ethernet ports and Ethernet repeater ports in VLAN 1. The default SAID is 100001 for VLAN 1, 100002 for VLAN 2, 100003 for VLAN 3, and so on. The default type is Ethernet. The default MTU is 1500 bytes. The default state is active.
The default TRBRF is 1005, the default TRCRF is 1003, and the default MTU for TRBRFs and TRCRFs is 4472. The default state is active. The default aremaxhop is 7; the default stemaxhop is 7.
Command Modes
Privileged EXEC
Usage Guidelines
You cannot use the set vlan command until the networking device is either in VTP transparent mode (set vtp mode) or until a VTP domain name has been set (set vtp).
Valid MTU values for Token Ring VLAN are 1500 or 4472. While you can enter any value for the MTU value, the value you enter defaults to the next lowest valid value.
You cannot set multiple VLANs for Inter-Switch Link (ISL) ports using this command. The VLAN name can be from 1 to 32 characters in length. If adding a new VLAN, the VLAN number must be within the range 2 to 1001. When modifying a VLAN, the valid range for the VLAN number is 2 to 1005.
On a new Token Ring VLAN, if you do not specify the parent parameter for a TRCRF, the default TRBRF (1005) is used.
Examples
The following example shows how to set VLAN 850 to include ports 4 through 7 on module 3. Because ports 4 through 7 were originally assigned to TRCRF 1003, the message reflects the modification of VLAN 1003.
Router# set vlan 850 3/4-7VLAN 850 modified.VLAN 1003 modified.VLAN Mod/Ports---- -----------------------850 3/4-7Related Commands
clear vlan
Deletes an existing VLAN from a management domain.
show vlans
Displays VLAN subinterfaces.
set vlan mapping
To map 802.1Q virtual LANs (VLANs) to Inter-Switch Link (ISL) VLANs, use the set vlan mapping command in privileged EXEC mode.
set vlan mapping dot1q 1q-vlan-number isl isl-vlan-number
Syntax Description
Defaults
No 802.1Q-to-ISL mappings are defined.
Command Modes
Privileged EXEC
Usage Guidelines
IEEE 802.1Q VLAN trunks support VLANs 1 through 4095. ISL VLAN trunks support VLANs 1 through 1000. The switch automatically maps 802.1Q VLANs 1000 and lower to ISL VLANs with the same number.
The native VLAN of the 802.1Q trunk cannot be used in the mapping.
Use this feature to map 802.1Q VLANs above 1000 to ISL VLANs. Note that if you map a 802.1Q VLAN over 1000 to an ISL VLAN, the corresponding 802.1Q VLAN will be blocked. For example, if you map 802.1Q VLAN 2000 to ISL VLAN 200, then 802.1Q VLAN 200 will be blocked.
You can map up to seven VLANs. Only one 802.1Q VLAN can be mapped to an ISL VLAN. For example, if 802.1Q VLAN 800 has been automatically mapped to ISL VLAN 800, do not manually map any other 802.1Q VLANs to ISL VLAN 800.
You cannot overwrite existing 802.1Q VLAN mapping. If the 802.1Q VLAN number is in the mapping table, the command is aborted. You must first clear that mapping.
If vlan-number does not exist, then either of the following occurs:
•
•
If the table is full, the command is aborted with an error message indicating the table is full.
Examples
The following example shows how to map VLAN 1022 to ISL VLAN 850:
Router# set vlan mapping dot1q 1022 isl 850Vlan 850 configuration successfulVlan mapping successfulThe following example shows the display if you enter a VLAN that does not exist:
Router# set vlan mapping dot1q 1017 isl 999Vlan mapping successfulWarning: vlan 999 non-existentVlan 999 configuration successfulThe following example shows the display if you enter an existing mapping:
Router# set vlan mapping dot1q 1033 isl 722722 exists in the mapping table. Please clear the mapping first.The following example shows the display if the mapping table is full:
Router# set vlan mapping dot1q 1099 isl 917Vlan Mapping Table Full.Related Commands
clear vlan mapping
Deletes existing 802.1Q VLAN to ISL VLAN-mapped pairs.
show vlans
Displays VLAN subinterfaces.
shortcut-frame-count
To specify the maximum number of times a packet can be routed to the default router within shortcut-frame time before an MPOA resolution request is sent, use the shortcut-frame-count command in MPC configuration mode. To restore the default shortcut-setup frame count value, use the no form of this command.
shortcut-frame-count count
no shortcut-frame-count
Syntax Description
Defaults
The default is 10 frames.
Command Modes
MPC configuration mode.
Command History
Examples
The following example sets the shortcut-setup frame count to 5 for the MPC:
shortcut-frame-count 5Related Commands
Overrides the control ATM address of an MPC or MPS.
Defines an MPC with a specified name.
Sets the shortcut-setup frame time (in seconds) for the MPC.
shortcut-frame-time
To set the shortcut-setup frame time (in seconds) for the MPC, use the shortcut-frame-time command in MPC configuration mode. To restore the default shortcut-setup frame-time value, use the no form of this command.
shortcut-frame-time time
no shortcut-frame-time
Syntax Description
Defaults
The default is 1 second.
Command Modes
MPC configuration
Command History
Examples
The following example sets the shortcut-setup frame time to 7 for the MPC:
shortcut-frame-time 7Related Commands
show adjacency
To display Cisco Express Forwarding (CEF) adjacency table information, use the show adjacency command in EXEC mode.
show adjacency [detail]
Syntax Description
Command Modes
EXEC
Command History
11.2 GS
This command was introduced to support the Cisco 12012 Gigabit Switch Router.
11.1 CC
Multiple platform support was added.
Usage Guidelines
This command is available only on routers that have RP cards.
Examples
The following is sample output from the show adjacency detail command.
Router# show adjacency detailProtocol Interface AddressIP Ethernet1/0/0 9.2.61.1(7)0 packets, 0 bytes00107BC30D5C00500B32D8200800ARP 02:01:49The encapsulation string 00107BC30D5C00500B32D8200800 is that of an adjacency used for traffic switched out of a router on an Ethernet link using Ethernet II encapsulation.
Table 3 describes the significant fields shown in the display.
Related Commands
show atm vc
To display information about private ATM virtual circuits (VCs), use the show atm vc command in privileged EXEC mode.
show atm vc [vcd]
Private VCs exist on the control interface of a LSC to support corresponding VCs on an extended label ATM interface.
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
VCs on the extended label ATM interfaces do not show up in the show atm vc command output. Instead, the show xtagatm vc command provides a similar output that shows information only on extended label ATM VCs.
Examples
In the following example, no VCD is specified and private VCs are present.
show atm vcAAL / Peak Avg. BurstInterface VCD VPI VCI Type Encapsulation Kbps Kbps Cells StatusATM1/0 1 0 40 PVC AAL5-SNAP 0 0 0 ACTIVEATM1/0 2 0 41 PVC AAL5-SNAP 0 0 0 ACTIVEATM1/0 3 0 42 PVC AAL5-SNAP 0 0 0 ACTIVEATM1/0 4 0 43 PVC AAL5-SNAP 0 0 0 ACTIVEATM1/0 5 0 44 PVC AAL5-SNAP 0 0 0 ACTIVEATM1/0 15 1 32 PVC AAL5-XTAGATM 0 0 0 ACTIVEATM1/0 17 1 34 TVC AAL5-XTAGATM 0 0 0 ACTIVEATM1/0 26 1 43 TVC AAL5-XTAGATM 0 0 0 ACTIVEATM1/0 28 1 45 TVC AAL5-XTAGATM 0 0 0 ACTIVEATM1/0 29 1 46 TVC AAL5-XTAGATM 0 0 0 ACTIVEATM1/0 33 1 50 TVC AAL5-XTAGATM 0 0 0 ACTIVETable 4 lists the significant fields in this display.
When you specify a VCD value and the VCD corresponds to that of a private VC on a control interface, the display output appears as follows:
show atm vc 15ATM1/0 33 1 50 TVC AAL5-XTAGATM 0 0 0 ACTIVE ATM1/0: VCD: 15, VPI: 1, VCI: 32, etype:0x8, AAL5 - XTAGATM, Flags: 0xD38PeakRate: 0, Average Rate: 0, Burst Cells: 0, VCmode: 0x0 XTagATM1, VCD: 1, VPI: 0, VCI: 32 OAM DISABLED, InARP DISABLED InPkts: 38811, OutPkts: 38813, InBytes: 2911240, OutBytes: 2968834 InPRoc: 0, OutPRoc: 0, Broadcasts: 0 InFast: 0, OutFast: 0, InAS: 0, OutAS: 0 OAM F5 cells sent: 0, OAM cells received: 0 Status: ACTIVETable 4 describes the fields shown in the output.
show cef
To display which packets the line cards dropped or to display which packets were not express forwarded, use the show cef command in EXEC mode.
show cef [drop | not-cef-switched]
Syntax Description
drop
(Optional) Displays which packets were dropped by each line card.
not-cef-switched
(Optional) Displays which packets were sent to a different switching path.
Command Modes
EXEC
Command History
11.2 GS
This command was introduced to support the Cisco 12012 Gigabit Switch Router.
11.1 CC
Multiple platform support was added.
Usage Guidelines
This command is available only on routers that have RSP cards.
A line card might drop packets because of encapsulation failure, absence of route information, or absence of adjacency information.
A packet is sent to a different switching path (punted) because Cisco Express Forwarding (CEF) does not support the encapsulation or feature, the packet is destined for the router, or the packet has IP options, such as time stamp and record route. IP options are process switched.
Examples
The following is sample output from the show cef drop command:
show cef dropCEF Drop StatisticsSlot Encap_fail Unresolved Unsupported No_route No_adj ChksumErrRP 4 89 0 4 0 01 0 0 0 0 0 02 0 0 5 0 0 5Table 5 describes the fields shown in the output.
The following is sample output from the show cef not-cef-switched command:
show cef not-cef-switchedCEF Packets passed on to next switching layerSlot No_adj No_encap Unsupp'ted Redirect Receive Options Access FragRP 0 0 0 0 91584 0 0 01 0 0 0 0 0 0 0 02 0 0 0 0 0 0 0 0Table 6 describes the fields shown in the output.
Related Commands
show cef interface
Displays CEF-related interface information.
show cef linecard
Displays CEF-related interface information by line card.
show cef interface
To display detailed Cisco Express Forwarding (CEF) information for all interfaces, use the show cef interface command in EXEC mode.
show cef interface [type number]
Syntax Description
type number
(Optional) Displays detailed CEF information for the specified interface type and number.
Command Modes
EXEC
Command History
11.2 GS
This command was introduced to support the Cisco 12012 Gigabit Switch Router.
11.1 CC
Multiple platform support was added.
Usage Guidelines
This command is available on routers that have RP cards and line cards.
You can use this command to show the detailed CEF status for all of the interfaces.
The type number keywords display CEF status information for the specified interface type and number.
Examples
The following is sample output from the show cef interface command for Fast Ethernet interface 0/0:
Router>show cef interface FastEthernet 0/0FastEthernet0/0 is up (if_number 3)Internet address is 172.19.177.20/24ICMP redirects are always sentPer-packet load-sharing is disabledIP unicast RPF check is disabledInbound access list is not setOutbound access list is not setIP policy routing is disabledHardware idb is FastEthernet0/0Fast switching type 1, interface type 18IP CEF switching enabledIP Fast switching turbo vectorIP Feature CEF switching turbo vectorInput fast flags 0x0, Output fast flags 0x0ifindex 1(1)Slot 0 Slot unit 0 VC -1Transmit limit accumulator 0x0 (0x0)IP MTU 1500Table 7 describes the fields shown in the output.
Related Commands
show cef linecard
To display Cisco Express Forwarding (CEF) related interface information by line card, use the show cef linecard command in EXEC mode.
show cef linecard [slot-number] [detail]
Syntax Description
Command Modes
EXEC
Command History
11.2 GS
This command was introduced to support the Cisco 12012 Gigabit Switch Router.
11.1 CC
Multiple platform support was added.
Usage Guidelines
This command is available only on routers that have RP cards.
When you omit the slot-number argument, information about all line cards is displayed. When you omit the slot-number argument and include the detail keyword, detailed information is displayed for all line cards. When you omit all keywords and arguments, the show cef linecard command displays important information about all line cards in table format.
Examples
The following is sample output from the show cef linecard command. The command displays information for the line cards.
show cef linecardCEF table version 115705, 45877 routesSlot CEF-ver MsgSent XdrSent Seq MaxSeq LowQ HighQ Flags1 238 668 9641 616 616 0 0 up, sync2 238 683 10782 619 629 0 0 up, syncTable 8 describes the fields shown in the output.
The following is sample output from the show cef linecard detail command for the line card in slot number 2:
show cef linecard 2 detailCEF line card slot number 2, status up, sync, disabledline card CEF version number 238Sequence number 616, Maximum sequence number expected 616Send failed 0, Out Of Sequence 0line card CEF reset 2, reloaded 292299/15/91 prefix/adjacency/interface elements queued49641 elements packed in 668 messages(1341286 bytes) sent0/0 xdr elements in LowQ/HighQInput packets 0, bytes 0 <--- line card statsOutput packets 0, bytes 0, drops 0Related Commands
show cef
Displays which packets the line cards dropped or displays which packets were not express-forwarded.
show cef interface
Displays CEF-related interface information.
show controllers vsi control-interface
To display information about an ATM interface that is configured with the tag-control-protocol vsi command to control an external switch, or, if an interface is not specified, about all VSI control interfaces, use the show controllers vsi control-interface command in EXEC mode.
show controllers vsi control-interface [interface]
Syntax Description
Command Modes
EXEC
Command History
Examples
The following is sample output from the show controllers vsi control-interface command:
show controllers vsi control-interfaceInterface: ATM2/0 Connections: 14The display shows the number of cross-connects currently on the switch that were established by the LSC through VSI over the control interface.
Related Commands
tag-control-protocol vsi
Configures the use of VSI on a particular master control port.
show controllers vsi descriptor
To display information about a switch interface discovered by the LSC through VSI, or, if no descriptor is specified, about all such discovered interfaces, use the show controllers vsi descriptor command in EXEC mode. You specify an interface by its (switch-supplied) physical descriptor.
show controllers vsi descriptor [descriptor]
Syntax Description
descriptor
(Optional) Physical descriptor. For the BPX, the physical descriptor has the following form:
slot.port.0
Command Modes
EXEC
Command History
Usage Guidelines
Per-interface information includes the interface name, the physical descriptor, the interface status, the physical interface state (supplied by the switch), acceptable VPI/VCI ranges, maximum cell rate, available cell rate (forward/backward), and available channels.
Similar information is displayed when you enter the show controllers XTagATM command. However, you must specify an IOS interface name instead of a physical descriptor.
Examples
The following is sample output from the show controllers vsi descriptor command:
show controllers vsi descriptor 12.2.0Phys desc: 12.2.0Log intf: 0x000C0200 (0.12.2.0)Interface: XTagATM0IF status: up IFC state: ACTIVE Min VPI: 1 Maximum cell rate: 10000 Max VPI: 259 Available channels: 2000 Min VCI: 32 Available cell rate (forward): 10000 Max VCI: 65535 Available cell rate (backward): 10000Table 9 lists the significant fields in this display.
Related Commands
show controllers vsi session
To display information about all sessions with VSI slaves, use the show controllers vsi session command in EXEC mode.
Note
show controllers vsi session [session-num [interface interface]]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
If a session number and an interface are specified, detailed information about the individual session is presented. If the session number is specified but the interface is omitted, detailed information about all sessions having that number is presented. (Only one session can have a given number in the first release, as multiple control interfaces are not supported.)
Examples
The following is sample output from the show controllers vsi session command:
show controllers vsi sessionInterface Session VCD VPI/VCI Switch/Slave Ids Session StateATM0/0 0 1 0/40 0/1 ESTABLISHED ATM0/0 1 2 0/41 0/2 ESTABLISHED ATM0/0 2 3 0/42 0/3 DISCOVERY ATM0/0 3 4 0/43 0/4 RESYNC-STARTING ATM0/0 4 5 0/44 0/5 RESYNC-STOPPING ATM0/0 5 6 0/45 0/6 RESYNC-UNDERWAY ATM0/0 6 7 0/46 0/7 UNKNOWN ATM0/0 7 8 0/47 0/8 UNKNOWN ATM0/0 8 9 0/48 0/9 CLOSING ATM0/0 9 10 0/49 0/10 ESTABLISHED ATM0/0 10 11 0/50 0/11 ESTABLISHED ATM0/0 11 12 0/51 0/12 ESTABLISHEDTable 10 lists the significant fields in this display.
In this example, session number 9 is specified with the show controllers vsi session command:
show controllers vsi session 9Interface: ATM1/0 Session number: 9VCD: 10 VPI/VCI: 0/49Switch type: BPX Switch id: 0Controller id: 1 Slave id: 10Keepalive timer: 15 Powerup session id: 0x0000000ACfg/act retry timer: 8/8 Active session id: 0x0000000AMax retries: 10 Ctrl port log intf: 0x000A0100Trap window: 50 Max/actual cmd wndw: 21/21Trap filter: all Max checksums: 19Current VSI version: 1 Min/max VSI version: 1/1Messages sent: 2502 Inter-slave timer: 4.000Messages received: 2502 Messages outstanding: 0Table 11 lists the significant fields in this display.
Related Commands
tag-control-protocol vsi
Configures the use of VSI on a particular master control port.
show controllers vsi status
To display a one-line summary of each VSI-controlled interface, use the show controllers vsi status command in EXEC mode.
show controllers vsi status
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
If an interface has been discovered by the LSC, but no extended label ATM interface has been associated with it through the extended-port interface configuration command, then the interface name is marked <unknown>, and interface status is marked "n/a".
Examples
The following is sample output from the show controllers vsi status command:
show controllers vsi statusInterface Name IF Status IFC State Physical Descriptor switch control port n/a ACTIVE 12.1.0 XTagATM0 up ACTIVE 12.2.0 XTagATM1 up ACTIVE 12.3.0 <unknown> n/a FAILED-EXT 12.4.0Table 12 lists the significant fields in this display.
show controllers vsi traffic
To display traffic information about VSI-controlled interfaces, VSI sessions, or VCs on VSI-controlled interfaces, use the show controllers vsi traffic command in EXEC mode.
show controllers vsi traffic [{descriptor descriptor | session session-num |
vc [descriptor descriptor [vpi vci ]]}]Syntax Description
descriptor descriptor
(Optional) Specifies the interface.
session session-num
(Optional) Specifies session number.
vpi
(Optional) Virtual path identifier.
vci
(Optional) Virtual circuit identifier.
Command Modes
EXEC
Command History
Usage Guidelines
If none of the optional command parameters is specified, traffic for all interfaces is displayed. You can specify a single interface by its (switch-supplied) physical descriptor. For the BPX, the physical descriptor has the form:
slot.port. 0
If a session number is specified, VSI protocol traffic counts by message type are displayed. The VC traffic display is the same as the one produced by the show xtagatm vc cross-connect traffic descriptor command.
Examples
The following is sample output from the show controllers vsi traffic command:
show controllers vsi trafficPhys desc: 10.1.0Interface: switch control portIF status: n/aRx cells: 304250 Rx cells discarded: 0Tx cells: 361186 Tx cells discarded: 0Rx header errors: 4294967254 Rx invalid addresses (per card): 80360Last invalid address: 0/53Phys desc: 10.2.0Interface: XTagATM0IF status: upRx cells: 202637 Rx cells discarded: 0Tx cells: 194979 Tx cells discarded: 0Rx header errors: 4294967258 Rx invalid addresses (per card): 80385Last invalid address: 0/32Phys desc: 10.3.0Interface: XTagATM1IF status: upRx cells: 182295 Rx cells discarded: 0Tx cells: 136369 Tx cells discarded: 0Rx header errors: 4294967262 Rx invalid addresses (per card): 80372Last invalid address: 0/32Table 13 lists the significant fields in this display.
The following sample output is displayed when you enter the show controllers vsi traffic session 9 command:
show controllers vsi traffic session 9Sent ReceivedSw Get Cnfg Cmd: 3656 Sw Get Cnfg Rsp: 3656Sw Cnfg Trap Rsp: 0 Sw Cnfg Trap: 0Sw Set Cnfg Cmd: 1 Sw Set Cnfg Rsp: 1Sw Start Resync Cmd: 1 Sw Start Resync Rsp: 1Sw End Resync Cmd: 1 Sw End Resync Rsp: 1Ifc Getmore Cnfg Cmd: 1 Ifc Getmore Cnfg Rsp: 1Ifc Cnfg Trap Rsp: 4 Ifc Cnfg Trap: 4Ifc Get Stats Cmd: 8 Ifc Get Stats Rsp: 8Conn Cmt Cmd: 73 Conn Cmt Rsp: 73Conn Del Cmd: 50 Conn Del Rsp: 0Conn Get Stats Cmd: 0 Conn Get Stats Rsp: 0Conn Cnfg Trap Rsp: 0 Conn Cnfg Trap: 0Conn Bulk Clr Stats Cmd: 0 Conn Bulk Clr Stats Rsp: 0Gen Err Rsp: 0 Gen Err Rsp: 0unused: 0 unused: 0unknown: 0 unknown: 0TOTAL: 3795 TOTAL: 3795Table 14 lists the significant fields in this display.
show controllers XTagATM
To display information about an extended label ATM interface or, if an interface is not specified, about all extended label ATM interfaces, that are controlled through the VSI protocol, use the show controllers XTagATM command in EXEC mode.
show controllers XTagATM if-num
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Per-interface information includes the interface name, the physical descriptor, the interface status, the physical interface state (supplied by the switch), acceptable VPI/VCI ranges, maximum cell rate, available cell rate (forward/backward), and available channels.
Similar information is displayed when you enter the show controllers vsi descriptor command However, you must specify an interface by its (switch-supplied) physical descriptor, instead of its IOS interface name. For the BPX, the physical descriptor has the form:
slot.port.0
Examples
In this example, the sample output is from the show controllers XTagATM command specifying interface 0.
show controllers XTagATM 0Interface XTagATM0 is up Hardware is Tag-Controlled ATM Port (on BPX switch BPX-VSI1) Control interface ATM1/0 is up Physical descriptor is 10.2.0 Logical interface 0x000A0200 (0.10.2.0) Oper state ACTIVE, admin state UP VPI range 1-255, VCI range 32-65535 VPI is not translated at end of link Tag control VC need not be strictly in VPI/VCI range Available channels: ingress 30, egress 30 Maximum cell rate: ingress 300000, egress 300000 Available cell rate: ingress 300000, egress 300000 Endpoints in use: ingress 7, egress 8, ingress/egress 1 Rx cells 134747 rx cells discarded 0, rx header errors 0 rx invalid addresses (per card): 52994 last invalid address 0/32 Tx cells 132564 tx cells discarded: 0Table 15 lists the significant fields in this display.
Related Commands
show interface stats
To display numbers of packets that were process-switched, fast-switched, and distributed-switched, use the show interface stats command in EXEC mode.
show interface type number stats
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the RP.
Note
Examples
The following is sample output from the show interface stats command:
show interface fddi 3/0/0 statsFddi3/0/0Switching path Pkts In Chars In Pkts Out Chars OutProcessor 3459994 1770812197 4141096 1982257456Route cache 10372326 3693920448 439872 103743545Distributed cache 19257912 1286172104 86887377 1184358085Total 33090232 2455937453 91468345 3270359086Table 16 describes the fields in the display.
