Cisco IOS Switching Services Command Reference, Release 12.2
Commands: name local seg-id through show interface stats
Downloads: This chapterpdf (PDF - 519.0KB) The complete bookPDF (PDF - 4.13MB) | Feedback

name local-seg-id

Table Of Contents

name local-seg-id

name preempt

name server-atm-address

neighbor activate

neighbor allowas-in

neighbor as-override

network-id

next-address

rate-limit

rd

route-target

set ip next-hop verify-availability

set mpls experimental

set ospf router-id

set vlan

set vlan mapping

shortcut-frame-count

shortcut-frame-time

show adjacency

show atm vc

show cable bundle

show cef drop

show cef events

show cef interface

show cef interface policy-statistics

show cef linecard

show cef not-cef-switched

show cef timers

show controllers vsi control-interface

show controllers vsi descriptor

show controllers vsi session

show controllers vsi status

show controllers vsi traffic

show controllers XTagATM

show interface stats


name local-seg-id

To specify or replace the ring number of the emulated LAN (ELAN) 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 ELAN. The maximum length of the name is 32 characters.

segment-number

Segment number to be assigned to the ELAN. The number ranges from 1 to 4095.


Defaults

No ELAN name or segment number is provided.

Command Modes

Database configuration

Command History

Release
Modification

11.3

This command was introduced.


Usage Guidelines

This command is ordinarily used for Token Ring LANE.

The same LANE ring number cannot be assigned to more than one ELAN.

The no form of this command deletes the relationships.

Examples

The following example specifies a ring number of 1024 for the ELAN named red:

name red local-seg-id 1024

Related Commands

Command
Description

default-name

Provides an ELAN name in the database of the configuration server for those client MAC addresses and client ATM addresses that do not have explicit ELAN name bindings.

lane database

Creates a named configuration database that can be associated with a configuration server.

mac-address

Sets the MAC-layer address of the Cisco Token Ring.


name preempt

To set the emulated LAN (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

elan-name

Specifies the name of the ELAN.


Defaults

Preemption is off by default.

Command Modes

LANE database configuration

Command History

Release
Modification

11.3

This command was introduced.


Usage Guidelines

In prior releases, when the primary LES failed, the 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. 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 preempt

name server-atm-address

To specify or replace the ATM address of the LANE server for the emulated LAN (ELAN) 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

elan-name

Name of the ELAN. Maximum length is 32 characters.

atm-address

LANE server's ATM address.

restricted | un-restricted

(Optional) Membership in the named ELAN is restricted to the LANE clients explicitly defined to the ELAN in the configuration server's database.

index number

(Optional) Priority number. When specifying multiple LANE servers for fault tolerance, you can specify a priority for each server. 0 is the highest priority.


Defaults

No emulated LAN name or server ATM address is provided.

Command Modes

Database configuration

Command History

Release
Modification

11.0

This command was introduced.

11.2

The following keywords were added:

un-restricted

index


Usage Guidelines

ELAN names must be unique within one named LANE configuration database.

Specifying an existing ELAN name with a new LANE server ATM address adds the LANE server ATM address for that ELAN 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 ELANs. The clients that can be assigned to the eng and mkt ELANs are specified using the client-atm-address commands. All other clients are assigned to the man ELAN.

lane database example3
 name eng server-atm-address 39.000001415555121101020304.0800.200c.1001.02 restricted
 name man server-atm-address 39.000001415555121101020304.0800.200c.1001.01
 name mkt server-atm-address 39.000001415555121101020304.0800.200c.4001.01 restricted
 client-atm-address 39.000001415555121101020304.0800.200c.1000.02 name eng
 client-atm-address 39.0000001415555121101020304.0800.200c.2000.02 name eng
 client-atm-address 39.000001415555121101020304.0800.200c.3000.02 name mkt
 client-atm-address 39.000001415555121101020304.0800.200c.4000.01 name mkt
 default-name man

Related Commands

Command
Description

client-atm-address name

Adds a LANE client address entry to the configuration database of the configuration server.

default-name

Provides an ELAN name in the database of the configuration server for those client MAC addresses and client ATM addresses that do not have explicit ELAN name bindings.

lane database

Creates a named configuration database that can be associated with a configuration server.

mac-address

Sets the MAC-layer address of the Cisco Token Ring.


neighbor activate

To enable the exchange of information with a neighboring router, use the neighbor activate command in address family configuration 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

ip-address

IP address of the neighboring router.

peer-group-name

Name of BGP peer group.


Defaults

The exchange of addresses with neighbors is enabled by default for the IPv4 address family. You can disable IPv4 address exchange using the no default bgp ipv4 activate command, or you can disable it for a particular neighbor using the no form of the neighbor activate command.

For all other address families, address exchange is disabled by default. You can explicitly activate the default command using the appropriate address family configuration.

Command Modes

Address family configuration

Router configuration

Command History

Release
Modification

12.0(5)T

This command was introduced.


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 named VPN IPv4 for all neighbors in the BGP peer group named PEPEER and for the neighbor 144.0.0.44:

address-family vpnv4
neighbor PEPEER activate
neighbor 144.0.0.44 activate
exit-address-family

Related Commands

Command
Description

address-family

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

ip-address

IP address of the neighboring router.

number

(Optional) Specifies the number of times to allow the advertisement of a PE router's ASN. Valid values are from 1 to 10. Valid values are from 1 to 10. If no number is supplied, the default value of 3 times is used.


Defaults

No default behavior or values.

Command Modes

Router configuration

Command History

Release
Modification

12.0(7)T

This command was introduced.

12.1

This command was integrated into Cicso IOS Release 12.1.

12.2

This command was integrated into Cicso IOS Release 12.2.


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 are as follows:

One Virtual Private Network routing and forwarding (VRF) instance receives prefixes with ASNs from all PE routers and then advertises them to neighboring PE routers.

The other VRF receives prefixes with ASNs from the CE router and readvertises them to all PE routers in the hub and spoke configuration.

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 100 
 address-family ipv4 vrf vrf1
 neighbor 192.168.255.255 allowas-in 6

Related Commands

Command
Description

address-family

Enters the address family configuration submode used to configure routing protocols such as 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

ip-address

Specifies the IP address of the router that is to be overridden with the ASN provided.


Defaults

No default behavior or values.

Command Modes

Router configuration

Command History

Release
Modification

12.0(7)T

This command was introduced.


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 100
 neighbor 192.168.255.255 remote-as 109
 neighbor 192.168.255.255 update-source loopback0
 address-family ipv4 vrf vpn1
 neighbor 192.168.255.255 activate
 neighbor 192.168.255.255 as-override

Related Commands

Command
Description

neighbor activate

Enables the exchange of information with a BGP neighboring router.

neighbor remote-as

Allows a neighboring router's IP address to be included in the BGP routing table.

neighbor update-source

Allows internal BGP sessions to use any operational interface for TCP/IP connections.

route-map

Redistributes routes from one routing protocol to another.


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 is 1), use the no form of this command.

network-id id

no network-id

Syntax Description

id

Specifies the network ID of the MPOA server.


Defaults

The default value for the network id is 1.

Command Modes

MPS configuration

Command History

Release
Modification

11.3(3a)WA4(5)

This command was introduced.


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 5

next-address

To specify the next IP address in the explicit path, use the next-address IP explicit path configuration command. To disable this feature, use the no form of this command.

next-address A.B.C.D

no next-address A.B.C.D

Syntax Description

A.B.C.D

Next IP address in the explicit path.


Defaults

No default behavior or values.

Command Modes

IP explicit path configuration

Command History

Release
Modification

12.0(5)S

This command was introduced.


Examples

In the following example, the number 60 is assigned to the IP explicit path, the path is enabled, and 3.3.27.3 is specified as the next IP address in the list of IP addresses:

Router(config)# ip explicit-path identifier 60 enable
Router(cfg-ip-expl-path)# next-address 3.3.27.3

Explicit Path identifier 60:
    1: next-address 3.3.27.3
Router(cfg-ip-exp1-path)#

Related Commands

Command
Description

append-after

Inserts the new path entry after the specified index number. Commands might be renumbered as a result.

index

Inserts or modifies a path entry at a specified index.

ip explicit-path

Enters the subcommand mode for IP explicit paths and creates or modifies the specified path.

list

Displays all or part of the explicit paths.

show ip explicit-paths

Displays configured IP explicit paths.


rate-limit

To configure CAR and DCAR policies, use the rate-limit interface configuration command. To remove the rate limit from the configuration, use the no form of this command.

rate-limit {input | output} [access-group [rate-limit] acl-index] bps
burst-normal burst-max
conform-action conform-action exceed-action exceed-action

no rate-limit {input | output}[access-group [rate-limit] acl-index] bps
burst-normal burst-max
conform-action conform-action exceed-action exceed-action

Syntax Description

input

Applies this CAR traffic policy to packets received on this input interface.

output

Applies this CAR traffic policy to packets sent on this output interface.

access-group

(Optional) Applies this CAR traffic policy to the specified access list.

rate-limit

(Optional) The access list is a rate-limit access list.

acl-index

(Optional) Access list number.

bps

Average rate (in bits per second). The value must be in increments of
8 kbps.

burst-normal

Normal burst size (in bytes). The minimum value is bits per second divided by 2000.

burst-max

Excess burst size (in bytes).

conform-action conform-action

Action to take on packets that conform to the specified rate limit. Specify one of the following keywords:

continue—Evaluates the next rate-limit command.

drop—Drops the packet.

set-dscp-continue—Sets the differentiated services code point (DSCP) (0 to 63) and evaluate the next rate-limit command.

set-dscp-transmit—Sends the DSCP and transmit the packet.

set-mpls-exp-continue—Sets the MPLS experimental bits (0 to 7) and evaluates the next rate-limit command.

set-mpls-exp-transmit—Sets the MPLS experimental bits (0 to 7) and sends the packet.

set-prec-continue—Sets the IP precedence (0 to 7) and evaluates the next rate-limit command.

set-prec-transmit—Sets the IP precedence (0 to 7) and sends the packet.

set-qos-continue—Sets the QoS group ID (1 to 99) and evaluates the next rate-limit command.

set-qos-transmit—Sets the QoS group ID (1 to 99) and sends the packet.

transmit—Sends the packet.

exceed-action exceed-action

Action to take on packets that exceed the specified rate limit. Specify one of the following keywords:

continue—Evaluates the next rate-limit command.

drop—Drops the packet.

set-dscp-continue—Sets the DSCP (0 to 63) and evaluates the next rate-limit command.

set-dscp-transmit—Sends the DSCP and sends the packet.

set-mpls-exp-continue—Sets the MPLS experimental bits (0 to 7) and evaluates the next rate-limit command.

set-mpls-exp-transmit—Sets the MPLS experimental bits (0 to 7) and sends the packet.

set-prec-continue—Sets the IP precedence (0 to 7) and evaluates the next rate-limit command.

set-prec-transmit—Sets the IP precedence (0 to 7) and sends the packet.

set-qos-continue—Sets the QoS group ID (1 to 99) and evaluates the next rate-limit command.

set-qos-transmit—Sets the QoS group ID (1 to 99) and sends the packet.

transmit—Sends the packet.


Defaults

CAR and DCAR are disabled.

Command Modes

Interface configuration

Command History

Release
Modification

11.1 CC

This command was introduced.

12.1(5)T

The conform and exceed actions were added for the MPLS experimental field.


Usage Guidelines

Use this command to configure your CAR policy on an interface. To specify multiple policies, enter this command once for each policy.

CAR and DCAR can be configured on an interface or subinterface.

Examples

In the following example, the rate is limited by application:

All World Wide Web traffic is sent. However, the MPLS experimental field for web traffic that conforms to the first rate policy is set to 5. For nonconforming traffic, the IP precedence is set to 0 (best effort). See the following commands in the example:

rate-limit input rate-limit access-group 101 20000000 24000 32000 conform-action
set-mpls-exp-transmit 5 exceed-action set-mpls-exp-transmit 0

access-list 101 permit tcp any any eq www

FTP traffic is sent with an MPLS experimental field of 5 if it conforms to the second rate policy. If the FTP traffic exceeds the rate policy, it is dropped. See the following commands in the example:

rate-limit input access-group 102 10000000 24000 32000
conform-action set-mpls-exp-transmit 5 exceed-action drop

access-list 102 permit tcp any any eq ftp

Any remaining traffic is limited to 8 Mbps, with a normal burst size of 16,000 bytes and an excess burst size of 24000 bytes. Traffic that conforms is sent with an MPLS experimental field of 5. Traffic that does not conform is dropped. See the following command in the example:

rate-limit input 8000000 16000 24000 conform-action set-mpls-exp-transmit 5
exceed-action drop

Notice that two access lists are created to classify the web and FTP traffic so that they can be handled separately by the CAR feature:

router(config)# interface Hssi0/0/0
router(config-if)# description 45Mbps to R2
router(config-if)# rate-limit input rate-limit access-group 101 20000000 24000 32000
  conform-action set-mpls-exp-transmit 5 exceed-action set-mpls-exp-transmit 0
router(config-if)# rate-limit input access-group 102 10000000 24000 32000
  conform-action set-mpls-exp-transmit 5 exceed-action drop
router(config-if)# rate-limit input 8000000 16000 24000 conform-action
  set-mpls-exp-transmit 5 exceed-action drop
router(config-if)# ip address 200.200.14.250 255.255.255.252
!
router(config-if)# access-list 101 permit tcp any any eq www
router(config-if)# access-list 102 permit tcp any any eq ftp

In the following example, the MPLS experimental field is set and the packet is sent:

router(config)# interface FastEtheret1/1/0
router(config)# rate-limit input 8000 1000 1000 access-group conform-action
  set mpls-exp-transmit 5 exceed-action set-mpls-exp-transmit 5

Related Commands

Command
Description

access-list rate-limit

Configures an access list for use with CAR policies.

show access-list rate-limit

Displays information about rate-limit access lists.

show interfaces rate-limit

Displays information about CAR for a specified interface.


rd

To create routing and forwarding tables for a VRF, use the rd command in VRF configuration submode.

rd route-distinguisher

Syntax Description

route-distinguisher

Adds an 8-byte value to an IPv4 prefix to create a VPN IPv4 prefix.


Defaults

There is no default. A route distinguisher (RD) must be configured for a VRF to be functional.

Command Modes

VRF configuration

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

A 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 an ASN-relative RD, in which case it is composed of an autonomous system number and an arbitrary number, or it is an IP-address-relative RD, 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:3.

32-bit IP address: your 16-bit number
For example, 192.168.122.15:1.

Examples

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_blue
rd 100:3
ip vrf vrf_red
173.13.0.12:200

Related Commands

Command
Description

ip vrf

Configures a VRF routing table.

show ip vrf

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 configuration 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

import

Imports routing information from the target VPN extended community.

export

Exports routing information to the target VPN extended community.

both

Imports both import and export routing information to the target VPN extended community.

route-target-ext-community

Adds the route-target extended community attributes to the VRF's list of import, export, or both (import and export) route-target extended communities.


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 configuration

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

The route-target command creates lists of import and export route-target extended communities for the specified VRF. Enter 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:

16-bit AS number:your 32-bit number
For example, 101:3.

32-bit IP address:your 16-bit number
For example, 192.168.122.15: 1.

Examples

The following example shows how to configure route-target extended community attributes for a VRF. The result of the command sequence is that VRF named 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_blue
route-target both 1000:1
route-target export 1000:2
route-target import 173.27.0.130:200

Related Commands

Command
Description

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 that the next hops of a route map is a CDP neighbor 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

Release
Modification

12.0(3)T

This command was introduced.


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:

It causes some performance degradation.

CDP must be configured on the interface.

The next hop must be a Cisco device with CDP enabled.

It is supported in process switching and CEF policy routing, but not available in dCEF, because of the dependency of the CDP neighbor database.

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 hops of the route map are the router's CDP neighbors 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 named test sequence 10, the subsequent packets of the same flow always take the same route map named test sequence 10, not route map named test sequence 20, because they all match or pass access list 1 check.

ip cef
interface ethernet0/0/1
 ip route-cache flow
 ip policy route-map test
route-map test permit 10
 match ip address 1
 set ip precedence priority
 set ip next-hop 50.0.0.8
 set ip next-hop verify-availability
route-map test permit 20

set mpls experimental

To configure a policy to set the MPLS experimental field within the modular QoS command-line interface (CLI), use the set mpls experimental policy-map configuration command. To disable the policy map, use the no form of this command.

set mpls experimental value

no set mpls experimental value

Syntax Description

value

Specifies the value used to set MPLS experimental bits defined by the policy map. Valid values are 0 to 7, and they can be space-delimited. For example, 3 4 7.


Defaults

No default behavior or values.

Command Modes

Policy-map configuration

Command History

Release
Modification

12.1(5)T

This command was introduced.


Usage Guidelines

Use the policy map to set the MPLS experimental field when it is undesirable to modify the IP precedence field.

Examples

The following example specifies a policy map named out_pmap. The policy map comprises class maps. Class map mpls_2 matches packets with MPLS experimental field 2 and resets the MPLS experimental field to 3.

router(config)# class-map mpls_2
   match mpls experimental 2
router(config)# policy-map out_pmap
   class mpls_2
      set mpls experimental 3

Related Commands

Command
Description

class-map

Creates a class map to be used for matching packets to the class specified.

policy-map

Creates a policy map that can be attached to one or more interfaces to specify a service policy.

service-policy

Attaches a policy map to an input interface or an output interface to be used as the service policy for that interface.


set 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

Release
Modification

12.0(7)T

This command was introduced.


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-site1
 redistribute bgp 100 metric-type 1 subnets
 network 202.0.0.0 0.0.0.255 area 1

router bgp 100
 neighbor 172.19.89. 62 remote-as 100
 access-list 1 permit 192.168.0.0
 route-map vpn1-site1-map permit 10
 match ip address 1
 set ospf router-id

Related Commands

Command
Description

router ospf

Enables OSPF routing, which places the router in 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

vlan-number

Number identifying the VLAN.

module

Number of the module. This argument is not valid when defining or configuring Token Ring Bridge Relay Functions (TRBRFs).

port

Number of the port on the module belonging to the VLAN; this argument does not apply to TRBRFs.

name name

(Optional) Defines a text string used as the name of the VLAN (1 to 32 characters).

type {ethernet | fddi | fddinet | trcrf | trbrf}

(Optional) Identifies the VLAN type. The default type is Ethernet.

state {active | suspend}

(Optional) Specifies whether the state of the VLAN is active or suspended. VLANs in suspended state do not pass packets. The default state is active.

said said

(Optional) Specifies the security association identifier. Possible values are 1 to 4294967294. The default is 100001 for VLAN1, 100002 for VLAN 2, 100003 for VLAN 3, and so on. This argument does not apply to Token Ring Concentrator Relay Functions (TRCRFs) or TRBRFs.

mtu mtu

(Optional) Specifies the maximum transmission unit (packet size, in bytes) that the VLAN can use. Possible values are 576 to 18190. The default is 1500 bytes.

ring hex-ring-number

(Optional) Specifies the logical ring number for Token Ring VLANs. Possible values are hexadecimal numbers 0x1 to 0xFFF. This argument is valid and required only when defining a TRCRF.

decring decimal-ring-number

(Optional) Specifies the logical ring number for Token Ring VLANs. Possible values are decimal numbers 1 to 4095. This argument is valid and required only when defining a TRCRF.

bridge bridge-number

(Optional) Specifies the identification number of the bridge. Possible values are hexadecimal numbers 0x1 to 0xF. For Token Ring VLANs, the default is 0F. This argument is not valid for TRCRFs.

parent vlan-number

(Optional) Sets a parent VLAN. The range for vlan-number is 2 to 1005. This argument identifies the TRBRF to which a TRCRF belongs and is required when defining a TRCRF.

mode {srt | srb}

(Optional) Specfifies the TRCRF bridging mode.

stp {ieee | ibm | auto}

(Optional) Specifies the Spanning Tree Protocol version for a TRBRF to use: source-routing transparent (ieee), source-route bridging (ibm), or automatic source selection (auto).

translation vlan-number

(Optional) Specifies a translational VLAN used to translate FDDI to Ethernet. Valid values are from 1 to 1005. This argument is not valid for defining or configuring Token Ring VLANs.

backupcrf {off | on}

(Optional) Specifies whether the TRCRF is a backup path for traffic.

aremaxhop hop-count

(Optional) Specifies the maximum number of hops for All-Routes Explorer frames. Possible values are 1 to 14. The default is 7. This argument is only valid when defining or configuring TRCRFs.

stemaxhop hop-count

(Optional) Specifies the maximum number of hops for Spanning-Tree Explorer frames. Possible values are 1 to 14. The default is 7. This argument is only valid when defining or configuring TRCRFs.


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-7
VLAN 850 modified.
VLAN 1003 modified.
VLAN  Mod/Ports
---- -----------------------
850   3/4-7

Related Commands

Command
Description

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

dot1q

Specifies the 802.1Q VLAN.

1q-vlan-number

Number identifying the 802.1Q VLAN; valid values are 1001 to 4095.

isl

Specifies the ISL VLAN.

isl-vlan-number

Number identifying the ISL VLAN; valid values are 1 to 1000.


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 switch is in server or transparent mode, the VLAN is created with all default values.

If the switch is in client mode, then the command proceeds without creating the VLAN. A warning will be given indicating that the VLAN does not exist.

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 850
Vlan 850 configuration successful
Vlan mapping successful

The following example shows the display if you enter a VLAN that does not exist:

Router# set vlan mapping dot1q 1017 isl 999
Vlan mapping successful
Warning: vlan 999 non-existent
Vlan 999 configuration successful

The following example shows the display if you enter an existing mapping:

Router# set vlan mapping dot1q 1033 isl 722
722 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 917
Vlan Mapping Table Full.

Related Commands

Command
Description

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

count

Shortcut-setup frame count. The default is 10 frames.


Defaults

The default is 10 frames.

Command Modes

MPC configuration

Command History

Release
Modification

11.3(3a)WA4(5)

This command was introduced.


Examples

The following example sets the shortcut-setup frame count to 5 for the MPC:

shortcut-frame-count 5

Related Commands

Command
Description

atm-address

Overrides the control ATM address of an MPC or MPS.

mpoa client config name

Defines an MPC with a specified name.

shortcut-frame-time

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

time

Shortcut-setup frame time (in seconds).


Defaults

The default is 1 second.

Command Modes

MPC configuration

Command History

Release
Modification

11.3(3a)WA4(5)

This command was introduced.


Examples

The following example sets the shortcut-setup frame time to 7 for the MPC:

shortcut-frame-time 7

Related Commands

Command
Description

atm-address

Overrides the control ATM address of an MPC or MPS.

mpoa client config name

Defines an MPC with a specified name.

shortcut-frame-count

Specifies 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.


show adjacency

To display Cisco Express Forwarding (CEF) adjacency table information, use the show adjacency command in EXEC mode.

show adjacency [type number] [detail] [summary]

Syntax Description

type number

(Optional) Displays CEF adjacency information for the specified interface type and number.

detail

(Optional) Displays detailed adjacency information, including Layer 2 information.

summary

(Optional) Displays CEF adjacency table summary information.


Command Modes

EXEC

Command History

Release
Modification

11.2 GS

This command was introduced to support the Cisco 12012 Internet router.

11.1 CC

Multiple platform support was added.


Usage Guidelines

This command is used to verify that an adjacency exits for a connected device, that the adjacency is valid, and that the MAC header rewrite string is correct.

Examples

The following is sample output from the show adjacency detail command:

Router# show adjacency detail

Protocol Interface                 Address
IP       Ethernet1/0/0             9.2.61.1(7)
                                   0 packets, 0 bytes
                                   00107BC30D5C
                                   00500B32D8200800
                                   ARP        02:01:49

The encapsulatuion string 00107BC30D5C00500B32D8200800 is that of an adjacency used for traffic switched out of a router on an Ethernet link using Ethernet II encapsulation.

The following is sample output from the show adjacency summary command:

Router# show adjacency summary

Adjacency Table has 1 adjacency
  Interface                 Adjacency Count
  Ethernet1/0/0             1

Table 3 describes the significant fields shown in the displays.

Table 3 show adjacency detail Field Descriptions 

Field
Description

Protocol

The routed protocol to which the adjacency is related.

Interface

The outgoing interface associated with the adjacency.

Address

The address can represent one of these addresses:

Next Hop address

Point-to-Point address

The number (in parenthesis) that follows this field indicates the number of internal references to the adjacency.

Source

The source where the adjacency was learned.

Encapsulation string

The string which is prepended to a packet before the packet is 
transmitted.

Time stamp

The time left before the adjacency rolls out of the adjacency table. A packet must use the same next hop to the destination.


Related Commands

Command
Description

clear adjacency

Clears CEF adjacency table.


show atm vc

To display all ATM permanent virtual circuits (PVCs) and switched virtual circuits (SVCs) and traffic information, use the show atm vc command in privileged EXEC mode.

show atm vc [vcd | interface interface-number]

Syntax Description

vcd

(Optional) Specifies the virtual circuit descriptor (VCD) about which to display information.

interface interface-number

(Optional) Interface number or subinterface number of the PVC or SVC. Displays all PVCs and SVCs on the specified interface or subinterface.

The interface-number uses one of the following formats, depending on what router platform you are using:

For the ATM Interface Processor (AIP) on Cisco 7500 series routers; for the ATM port adapter, ATM-CES port adapter, and enhanced ATM port adapter on Cisco 7200 series routers; for the 1-port ATM-25 network module on Cisco 2600 and 3600 series routers: slot/0[.subinterface-number multipoint]

For the ATM port adapter and enhanced ATM port adapter on Cisco 7500 series routers: slot/port-adapter/0[.subinterface-number multipoint]

For the network processing module (NPM) on Cisco 4500 and Cisco 4700 routers: number[.subinterface-number multipoint]

For a description of these arguments, refer to the interface atm command.


Command Modes

Privileged EXEC

Command History

Release
Modification

10.0

This command was introduced.

11.1CA

Information about VCs on an ATM-CES port adapter was added to the command output.

12.0(5)T

Information about VCs on an extended Multiprotocol Label Switching (MPLS) ATM interface was added to the command output.

12.2(25)S

Information about packet drops and errors was added to the command output.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB and implemented on the Cisco 10000 series routers.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Usage Guidelines

If no value is specified for the vcd argument, the command displays information for all PVCs and SVCs. The output is in summary form (one line per virtual circuit).

VCs on the extended MPLS ATM interfaces do not appear in the show atm vc command output. Instead, the show xtagatm vc command provides a similar output that shows information only on extended MPLS ATM VCs.

Examples

The following is sample output from the show atm vc command when no vcd value is specified. The status field is either ACTIVE or INACTIVE.

Router# show atm vc

Interface     VCD   VPI   VCI Type  AAL/Encaps     Peak   Avg.  Burst Status
ATM2/0          1     0     5  PVC  AAL5-SAAL     155000 155000    93 ACTIVE
ATM2/0.4        3     0    32  SVC  AAL5-SNAP     155000 155000    93 ACTIVE
ATM2/0.65432   10    10    10  PVC  AAL5-SNAP     100000  40000    10 ACTIVE
ATM2/0         99     0    16  PVC  AAL5-ILMI     155000 155000    93 ACTIVE
ATM2/0.105    250    33    44  PVC  AAL5-SNAP     155000 155000    93 ACTIVE
ATM2/0.100    300    22    33  PVC  AAL5-SNAP     155000 155000    93 ACTIVE
ATM2/0.12345 2047   255 65535  PVC  AAL5-SNAP         56     28  2047 ACTIVE

The following is sample output from the show atm vc command when a vcd value is specified for a circuit emulation service (CES) circuit:

Router# show atm vc 2

ATM6/0: VCD: 2, VPI: 10, VCI: 10
PeakRate: 2310, Average Rate: 2310, Burst Cells: 94
CES-AAL1, etype:0x0, Flags: 0x20138, VCmode: 0x0
OAM DISABLED
InARP DISABLED
OAM cells received: 0
OAM cells sent: 334272
Status: ACTIVE

The following is sample output from the show atm vc command when a vcd value is specified, displaying statistics for that virtual circuit only:

Router# show atm vc 8

ATM4/0: VCD: 8, VPI: 8, VCI: 8
PeakRate: 155000, Average Rate: 155000, Burst Cells: 0
AAL5-LLC/SNAP, etype:0x0, Flags: 0x30, VCmode: 0xE000
OAM frequency: 0 second(s)
InARP frequency: 1 minute(s)
InPkts: 181061, OutPkts: 570499, InBytes: 757314267, OutBytes: 2137187609
InPRoc: 181011, OutPRoc: 10, Broadcasts: 570459
InFast: 39, OutFast: 36, InAS: 11, OutAS: 6
OAM cells received: 0
OAM cells sent: 0
Status: UP

The following is sample output from the show atm vc command when a vcd value is specified, AAL3/4 is enabled, an ATM Switched Multimegabit Data Service (SMDS) subinterface has been defined, and a range of message identifier numbers (MIDs) has been assigned to the PVC:

Router# show atm vc 1

ATM4/0.1: VCD: 1, VPI: 0, VCI: 1
PeakRate: 0, Average Rate: 0, Burst Cells: 0
AAL3/4-SMDS, etype:0x1, Flags: 0x35, VCmode: 0xE200
MID start: 1, MID end: 16
InPkts: 0, OutPkts: 0, InBytes: 0, OutBytes: 0
InPRoc: 0, OutPRoc: 0, Broadcasts: 0
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0

The following is sample output from the show atm vc command when a vcd value is specified and generation of Operation, Administration, and Maintenance (OAM) F5 loopback cells has been enabled:

Router# show atm vc 7

ATM4/0: VCD: 7, VPI: 7, VCI: 7 
PeakRate: 0, Average Rate: 0, Burst Cells: 0
AAL5-LLC/SNAP, etype:0x0, Flags: 0x30, VCmode: 0xE000
OAM frequency: 10 second(s)
InARP DISABLED
InPkts: 0, OutPkts: 0, InBytes: 0, OutBytes: 0
InPRoc: 0, OutPRoc: 0, Broadcasts: 0
InFast:0, OutFast:0, InAS:0, OutAS:0
OAM cells received: 0
OAM cells sent: 1
Status: UP

The following is sample output from the show atm vc command when a vcd value is specified, and there is an incoming multipoint virtual circuit:

Router# show atm vc 3

ATM2/0: VCD: 3, VPI: 0, VCI: 33
PeakRate: 0, Average Rate: 0, Burst Cells: 0
AAL5-MUX, etype:0x809B, Flags: 0x53, VCmode: 0xE000
OAM DISABLED
InARP DISABLED
InPkts: 6646, OutPkts: 0, InBytes: 153078, OutBytes: 0
InPRoc: 6646, OutPRoc: 0, Broadcasts: 0
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0
interface =  ATM2/0, call remotely initiated, call reference = 18082
vcnum = 3, vpi = 0, vci = 33, state = Active
 aal5mux vc, multipoint call
Retry count: Current = 0, Max = 10
timer currently inactive, timer value = never
Root Atm Nsap address: DE.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12

The following is sample output from the show atm vc command when a vcd value is specified, and there is an outgoing multipoint virtual circuit:

Router# show atm vc 6

ATM2/0: VCD: 6, VPI: 0, VCI: 35
PeakRate: 0, Average Rate: 0, Burst Cells: 0
AAL5-MUX, etype:0x800, Flags: 0x53, VCmode: 0xE000
OAM DISABLED
InARP DISABLED
InPkts: 0, OutPkts: 818, InBytes: 0, OutBytes: 37628
InPRoc: 0, OutPRoc: 0, Broadcasts: 818
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0
interface =  ATM2/0, call locally initiated, call reference = 3
vcnum = 6, vpi = 0, vci = 35, state = Active
 aal5mux vc, multipoint call
Retry count: Current = 0, Max = 10
timer currently inactive, timer value = never
Leaf Atm Nsap address: DE.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12
Leaf Atm Nsap address: CD.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12

The following is sample output from the show atm vc command when a vcd value is specified and there is a PPP-over-ATM connection:

Router# show atm vc 1

ATM8/0.1: VCD: 1, VPI: 41, VCI: 41
PeakRate: 155000, Average Rate: 155000, Burst Cells: 96
AAL5-CISCOPPP, etype:0x9, Flags: 0xC38, VCmode: 0xE000
virtual-access: 1, virtual-template: 1
OAM DISABLED
InARP DISABLED
InPkts: 13, OutPkts: 10, InBytes: 198, OutBytes: 156
InPRoc: 13, OutPRoc: 10, Broadcasts: 0
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0
OAM cells received: 0
OAM cells sent: 0

The following is sample output from the show atm vc command for IP multicast virtual circuits. The display shows the leaf count for multipoint VCs opened by the root. VCD 3 is a root of a multipoint VC with three leaf routers. VCD 4 is a leaf of some other router's multipoint VC. VCD 12 is a root of a multipoint VC with only one leaf router.

Router# show atm vc

            VCD/                                Peak     Avg/Min     Burst
Interface   Name  VPI   VCI   Type     Encaps      Kbps    Kbps      Cells         Sts
0/0         1       0     5    PVC      SAAL     155000  155000       96           UP
0/0         2       0    16    PVC      ILMI     155000  155000       96           UP
0/0         3       0   124 MSVC-3      SNAP     155000  155000       96           UP
0/0         4       0   125   MSVC      SNAP     155000  155000       96           UP
0/0         5       0   126   MSVC      SNAP     155000  155000       96           UP
0/0         6       0   127   MSVC      SNAP     155000  155000       96           UP
0/0         9       0   130   MSVC      SNAP     155000  155000       96           UP
0/0         10      0   131    SVC      SNAP     155000  155000       96           UP
0/0         11      0   132 MSVC-3      SNAP     155000  155000       96           UP
0/0         12      0   133 MSVC-1      SNAP     155000  155000       96           UP
0/0         13      0   134    SVC      SNAP     155000  155000       96           UP
0/0         14      0   135 MSVC-2      SNAP     155000  155000       96           UP
0/0         15      0   136 MSVC-2      SNAP     155000  155000       96           UP

The following is sample output from the show atm vc command for an IP multicast virtual circuit. The display shows the owner of the VC and leaves of the multipoint VC. This VC was opened by IP multicast. The three leaf routers' ATM addresses are included in the display. The VC is associated with IP group address 10.1.1.1.

Router# show atm vc 11

ATM0/0: VCD: 11, VPI: 0, VCI: 132
PeakRate: 155000, Average Rate: 155000, Burst Cells: 96
AAL5-LLC/SNAP, etype:0x0, Flags: 0x650, VCmode: 0xE000
OAM DISABLED
InARP DISABLED
InPkts: 0, OutPkts: 12, InBytes: 0, OutBytes: 496
InPRoc: 0, OutPRoc: 0, Broadcasts: 12
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0
OAM cells received: 0
OAM cells sent: 0
Status: ACTIVE, TTL: 2, VC owner: IP Multicast (10.1.1.1)
interface =  ATM0/0, call locally initiated, call reference = 2
vcnum = 11, vpi = 0, vci = 132, state = Active
 aal5snap vc, multipoint call
Retry count: Current = 0, Max = 10
timer currently inactive, timer value = 00:00:00
Leaf Atm Nsap address: 47.0091810000000002BA08E101.444444444444.02 
Leaf Atm Nsap address: 47.0091810000000002BA08E101.333333333333.02 
Leaf Atm Nsap address: 47.0091810000000002BA08E101.222222222222.02 

The following is sample output from the show atm vc command where no VCD is specified and private VCs are present:

Router# show atm vc

AAL /         Peak   Avg.  Burst       
Interface     VCD   VPI   VCI Type  Encapsulation  Kbps   Kbps  Cells Status
ATM1/0          1     0    40  PVC  AAL5-SNAP          0      0     0 ACTIVE  
ATM1/0          2     0    41  PVC  AAL5-SNAP          0      0     0 ACTIVE  
ATM1/0          3     0    42  PVC  AAL5-SNAP          0      0     0 ACTIVE  
ATM1/0          4     0    43  PVC  AAL5-SNAP          0      0     0 ACTIVE  
ATM1/0          5     0    44  PVC  AAL5-SNAP          0      0     0 ACTIVE  
ATM1/0         15     1    32  PVC  AAL5-XTAGATM       0      0     0 ACTIVE  
ATM1/0         17     1    34  TVC  AAL5-XTAGATM       0      0     0 ACTIVE  
ATM1/0         26     1    43  TVC  AAL5-XTAGATM       0      0     0 ACTIVE  
ATM1/0         28     1    45  TVC  AAL5-XTAGATM       0      0     0 ACTIVE  
ATM1/0         29     1    46  TVC  AAL5-XTAGATM       0      0     0 ACTIVE  
ATM1/0         33     1    50  TVC  AAL5-XTAGATM       0      0     0 ACTIVE 

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:

Router# show atm vc 15

ATM1/0 33     1    50  TVC  AAL5-XTAGATM       0      0     0 ACTIVE 
ATM1/0: VCD: 15, VPI: 1, VCI: 32, etype:0x8, AAL5 - XTAGATM, Flags: 0xD38
PeakRate: 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: ACTIVE

Table 4 describes the fields shown in the displays.

Table 4 show atm vc Field Descriptions 

Field
Description

Interface

Interface slot and port.

VCD/Name

Virtual circuit descriptor (virtual circuit number). The connection name is displayed if the virtual circuit (VC) was configured using the pvc command and the name was specified.

VPI

Virtual path identifier.

VCI

Virtual channel identifier.

Type

Type of VC, either PVC, SVC, TVC, or multipoint SVC (MSVC).

MSVC (with no -x) indicates that VCD is a leaf of some other router's multipoint VC.

MSVC-x indicates there are x leaf routers for that multipoint VC opened by the root.

Type of PVC detected from PVC discovery, either PVC-D, PVC-L, or PVC-M.

PVC-D indicates a PVC created due to PVC discovery.

PVC-L indicates that the corresponding peer of this PVC could not be found on the switch.

PVC-M indicates that some or all of the Quality of Service (QoS) parameters of this PVC do not match those of the corresponding peer on the switch.

TVC indicates a Tag VC.

Encaps

Type of ATM adaptation layer (AAL) and encapsulation.

PeakRate

Kilobits per second sent at the peak rate.

Average Rate

Kilobits per second sent at the average rate.

Burst Cells

Value that equals the maximum number of ATM cells the VC can send at peak rate.

Status

Status of the VC connection.

UP indicates that the connection is enabled for data traffic.

DOWN indicates that the connection is not ready for data traffic. When the Status field is DOWN, a State field is shown.

INACTIVE indicates that the interface is down.

ACTIVE indicates that the interface is in use and active.

etype

Encapsulation type.

Flags

Bit mask describing VC information. The flag values are summed to result in the displayed value.

0x10000 ABR VC
0x20000 CES VC
0x40000 TVC
0x100 TEMP (automatically created)
0x200 MULTIPOINT
0x400 DEFAULT_RATE
0x800 DEFAULT_BURST
0x10 ACTIVE
0x20 PVC
0x40 SVC
0x0 AAL5-SNAP
0x1 AAL5-NLPID
0x2 AAL5-FRNLPID
0x3 AAL5-MUX
0x4 AAL3/4-SMDS
0x5 QSAAL
0x6 AAL5-ILMI
0x7 AAL5-LANE
0x8 AAL5-XTAGATM
0x9 CES-AAL1
0xA F4-OAM

VCmode

AIP-specific or NPM-specific register describing the usage of the VC. This register contains values such as rate queue, peak rate, and AAL mode, which are also displayed in other fields.

OAM frequency

Seconds between OAM loopback messages, or DISABLED if OAM is not in use on this VC.

InARP frequency

Minutes between Inverse Address Resolution Protocol (InARP) messages, or DISABLED if InARP is not in use on this VC.

virtual-access

Virtual access interface identifier.

virtual-template

Virtual template identifier.

InPkts

Total number of packets received on this VC. This number includes all fast-switched and process-switched packets.

OutPkts

Total number of packets sent on this VC. This number includes all fast-switched and process-switched packets.

InBytes

Total number of bytes received on this VC. This number includes all fast-switched and process-switched packets.

OutBytes

Total number of bytes sent on this VC. This number includes all fast-switched and process-switched packets.

InPRoc

Number of process-switched input packets.

OutPRoc

Number of process-switched output packets.

Broadcasts

Number of process-switched broadcast packets.

InFast

Number of fast-switched input packets.

OutFast

Number of fast-switched output packets.

InAS

Number of autonomous-switched or silicon-switched input packets.

VC TxRingLimit

Transmit Ring Limit for this VC.

VC Rx Limit

Receive Ring Limit for this VC.

Transmit priority

ATM service class transmit priority for this VC.

InCells

Number of incoming cells on this VC.

OutCells

Number of outgoing cells on this VC.

InPktDrops

A non-zero value for the InPktDrops of a VC counter suggests that the ATM interface is running out of packet buffers for an individual VC, or is exceeding the total number of VC buffers that can be shared by the VCs.

OutPktDrops

The PA-A3 driver increments the OutPktDrops counter when a VC fills its individual transmit buffer quota. The purpose of the quota is to prevent a consistently over-subscribed VC from grabbing all of the packet buffer resources and hindering other VCs from transmitting normal traffic within their traffic contracts.

InCellDrops

Number of incoming cells dropped on this VC.

OutCellDrops

Number of outgoing cells dropped on this VC.

InByteDrops

Number of incoming bytes that are dropped on this VC.

OutByteDrops

Number of outgoing bytes that are dropped on this VC.

CrcErrors

Number of cyclic redundancy check (CRC) errors on this VC.

SarTimeOuts

Number of segmentation and reassembly sublayer time-outs on this VC.

OverSizedSDUs

Number of over-sized service data units on this VC

LengthViolation

Number of length violations on this VC. A length violation occurs when a reassembled packet is dropped without checking the CRC.

CPIErrors

The Common Part Indicator error field is a one octet field in the AAL5 encapsulation of an ATM cell and must be set to 0. If it is received with some other value, it is flagged as an error by the interface. For example, this error may indicate data corruption.

Out CLP

Number of Packets and/or cells where the Output Cell Loss Priority bit is set.

OutAS

Number of autonomous-switched or silicon-switched output packets.

OAM cells received

Number of OAM cells received on this VC.

OAM cells sent

Number of OAM cells sent on this VC.

TTL

Time to live in ATM hops across the VC.

VC owner

IP Multicast address of the group.


Related Commands

Command
Description

atm nsap-address

Sets the NSAP address for an ATM interface using SVC mode.

show xtagatm vc

Displays information about the VCs on the extended MPLS ATM interfaces.


show cable bundle

To display the forwarding table for the specified interface, use the show cable bundle privileged EXEC command.

show cable bundle bundle-number forwarding-table

Syntax Description

bundle-number

Specifies the bundle identifier. Valid range is from 1 to 255.

forwarding-table

Displays the forwarding table for the specified interface.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR

This command was introduced.


Examples

In the following example, a cable bundle of 25 is specified:

Router# show cable bundle 25 forwarding-table

MAC address         Interface
0050.7366.17ab      Cable3/0
0050.7366.1803      Cable3/0
0050.7366.1801      Cable3/0

The fields in the display are described as follows:

MAC address—Media Access Control ID for each interface in the bundle.

Interface—The cable interface slot and port number.

Related Commands

Command
Description

cable bundle

Creates an interface bundle.


show cef drop

To display a list of which packets each line card dropped, use the show cef drop command in user EXEC or privileged EXEC mode.

show cef drop

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.2 GS

This command was introduced to support the Cisco 12012 Internet router.

11.1 CC

Multiple platform support was added.

12.0(22)S

The display output for this command was modified to include support for Cisco Express Forwarding for IPv6 (CEFv6) and distributed CEF for IPv6 (dCEFv6) packets.

12.0(23)S

This command was integrated into Cisco IOS Release 12.0(23)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T. Previously there was a show cef command, and drop was a keyword of that command.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.


Usage Guidelines

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 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.


Note If CEFv6 or dCEFv6 is enabled globally on the router, the show cef drop command displays IPv6 CEF counter information and IPv4 CEF counter information. If CEFv6 or dCEFv6 is not enabled globally on the router, the command displays only IPv4 CEF counter information.


Examples

The following is sample output from the show cef drop command:

Router# show cef drop

CEF Drop Statistics
Slot  Encap_fail  Unresolved Unsupported    No_route      No_adj   ChksumErr
RP             4          89           0           4           0           0
1              0           0           0           0           0           0
2              0           0           5           0           0           5
IPv6 CEF Drop Statistics
Slot  Encap_fail  Unresolved Unsupported    No_route      No_adj
RP             2          33           0           2           0
1              0          0            3           0           0
2              0          0            0           0           0

Table 5 describes the significant fields shown in the display.

Table 5 show cef drop Field Descriptions 

Field
Description

Slot

The slot number on which the packets were received.

Encap_fail

Indicates the number of packets dropped after exceeding the limit for packets punted to the processor due to missing adjacency information (CEF throttles packets passed up to the process level at a rate of one packet per second).

Unresolved

Indicates the number of packets dropped due to an unresolved prefix in the Forwarding Information Base (FIB) table.

Unsupported

Indicates the number of packets fast-dropped by CEF (drop adjacency).

No_route

Indicates the number of packets dropped due to a missing prefix in the FIB table.

No_adj

Indicates the number of packets dropped due to incomplete adjacency.

ChksumErr

Indicates the number of IPv4 packets received with a checksum error.

Note This field is not supported for IPv6 packets.


Related Commands

Command
Description

show cef interface

Displays CEF-related interface information.

show ipv6 cef

Displays entries in the IPv6 FIB.


show cef events

To display a list of events internal to the CEF process, use the show cef events command in user EXEC or privileged EXEC mode.

show cef events

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.0(24)S

This command was integrated into Cisco IOS Release 12.0(24)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.


Examples

The following is sample output from the show cef events command:

Router# show cef events 

CEF events (14/0 recorded/ignored)

Time            Event     Details
+00:00:00.000   SubSys    ipfib init
+00:00:00.000   SubSys    ipfib_ios init
+00:00:00.000   SubSys    ipfib_util init
+00:00:00.000   SubSys    adj_ios init
+00:00:00.000   SubSys    ipfib_les init
+00:00:01.272   Flag      FIB enabled set to yes
+00:00:01.272   Flag      FIB switching enabled set to yes
+00:00:01.272   GState    CEF enabled
+00:00:02.872   Process   Background created
+00:00:02.872   Flag      FIB running set to yes
+00:00:02.872   Process   Background event loop enter
+00:00:02.912   Flag      FIB switching running set to yes
+00:00:02.920   Process   Scanner created
+00:00:02.920   Process   Scanner event loop enter

Table 6 describes the significant fields shown in the display.

Table 6 show cef events Field Descriptions 

Field
Description

Time

Time that the event occurred.

Event

Type of event that occurred.

Details

Detailed description of the event.


Related Commands

Command
Description

show cef drop

Displays a list of which packets each line card dropped.

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] [statistics] [detail]

Syntax Description

type number

(Optional) Displays CEF information for the specified interface type and number.

statistics

(Optional) Displays switching statistics for the line card.

detail

(Optional) Displays detailed CEF information for the specified interface type and number.


Command Modes

EXEC

Command History

Release
Modification

11.2 GS

This command was introduced to support the Cisco 12012 Internet router.

11.1 CC

Multiple platform support was added.

12.0(23)S

This command was integrated into Cisco IOS Release 12.0(23)S.

12.0(14)ST

Updated documentation for statistics keyword.

12.2(2)T

Updated documentation for statistics and detail keywords.


Usage Guidelines

You can use this command to show the detailed CEF status for all of the interfaces.

The type number arguments display CEF status information for the specified interface type and number.

Examples

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

Router# show cef interface Ethernet 1/0/0 detail

Ethernet1/0/0 is up (if_number 9)
  Corresponding hwidb fast_if_number 9
  Corresponding hwidb firstsw->if_number 9
  Internet address is 9.2.61.8/24
  ICMP redirects are always sent
  Per packet load-sharing is disabled
  IP unicast RPF check is disabled
  Inbound access list is not set
  Outbound access list is not set
  IP policy routing is disabled
  Hardware idb is Ethernet1/0/0
  Fast switching type 1, interface type 5
  IP Distributed CEF switching enabled
  IP Feature Fast switching turbo vector
  IP Feature CEF switching turbo vector
  Input fast flags 0x0, Output fast flags 0x0
  ifindex 7(7)
  Slot 1 Slot unit 0 VC -1
  Transmit limit accumulator 0x48001A82 (0x48001A82)
  IP MTU 1500

The following is sample output from the show cef interface Null 0 detail command:

Router# show cef interface Null 0 detail

Null0 is up (if_number 1)
  Corresponding hwidb fast_if_number 1
  Corresponding hwidb firstsw->if_number 1
  Internet Protocol processing disabled
  Interface is marked as nullidb
  Packets switched to this interface on linecard are dropped to next slow path
  Hardware idb is Null0
  Fast switching type 13, interface type 0
  IP CEF switching enabled
  IP Feature CEF switching turbo vector
  Input fast flags 0x0, Output fast flags 0x0
  ifindex 0(0)
  Slot -1 Slot unit -1 VC -1
  Transmit limit accumulator 0x0 (0x0)
  IP MTU 1500

Table 7 describes the significant fields shown in the display.

Table 7 show cef interface Field Descriptions 

Field
Description

Ethernet1/0/0 is {up | down}

Indicates type, number, and status of the interface.

Internet address is

Internet address of the interface.

ICMP redirects are always sent

Indicates how packet forwarding is configured.

Per packet load-sharing is disabled

Indicates status of load sharing on the interface.

IP unicast RPF check is disabled

Indicates status of IP unicast Reverse Path Forwarding (RPF) check on the interface.

Inbound access list is not set

Indicates the number or name of the inbound access list if one is applied to this interface.

Outbound access list is not set

Indicates the number or name of the outbound access list if one is applied to this interface.

IP policy routing is disabled

Indicates the status of IP policy routing on the interface.

Hardware idb is Ethernet1/0/0

Interface type and number configured.

Fast switching type

Used for troubleshooting; indicates switching mode in use.

interface type 5

Indicates interface type.

IP Distributed CEF switching enabled

Indicates whether distributed CEF is enabled on this interface. (7500 and 12000 series Internet routers only.)

IP Feature Fast switching turbo vector

Indicates IP fast switching type configured.

IP Feature CEF switching turbo vector

Indicates IP feature CEF switching type configured.

Input fast flags

Indicates the input status of various switching features as follows:

0x0001 (input Access Control List [ACL] enabled)

0x0002 (policy routing enabled)

0x0004 (input rate limiting)

0x0008 (MAC/Prec accounting)

0x0010 (DSCP/PREC/QOS GROUP)

0x0020 (input named access lists)

0x0040 (NAT enabled on input)

0x0080 (crypto map on input)

0x0100 (QPPB classification)

0x0200 (inspect on input)

0x0400 (input classification)

0x0800 (casa input enable)

0x1000 (Virtual Private Network [VPN] enabled on a swidb)

0x2000 (input idle timer enabled)

0x4000 (unicast Reverse Path Forwarding [RPF] check)

0x8000 (per-address ACL enabled)

0x10000 (Deaggregating a packet)

0x20000 (GPRS enabled on input)

0x40000 (URL RenDezvous)

0x80000 (QoS classification)

0x100000 (FR switching on i/f)

0x200000 (WCCP redirect on input)

0x400000 (input classification)

Output fast flags

Indicates the output status of various switching features:

0x0001 (output ACL enabled)

0x0002 (IP accounting enabled)

0x0004 (WCC redirect enable i/f)

0x0008 (rate limiting)

0x0010 (MAC/Prec accounting)

0x0020 (DSCP/PREC/QOS GROUP)

0x0040 (D-QOS classification)

0x0080 (output named access lists)

0x0100 (NAT enabled on output)

0x0200 (TCP intercept enabled)

0x0400 (crypto map set on output)

0x0800 (output firewall)

0x1000 (RSVP classification)

0x2000 (inspect on output)

0x4000 (QoS classification)

0x8000 (QoS pre-classification)

0x10000 (output stile)

ifindex 7/(7)

Indicates the SNMP ifindex for this interface.

Slot 1 Slot unit 0 VC -1

The slot number and slot unit.

Transmit limit accumulator

Indicates the maximum number of packets allowed in the transmit queue.

IP MTU

The value of the MTU size set on the interface.


Related Commands

Command
Description

show cef drop

Displays a list of which packets each line card dropped.

show cef linecard

Displays CEF-related interface information by line card.


show cef interface policy-statistics

To display detailed Cisco Express Forwarding (CEF) policy statistical information for all interfaces, use the show cef interface policy-statistics command in EXEC mode.

show cef interface [type number] policy-statistics

Syntax Description

type number

(Optional) Displays CEF information for the specified interface type and number.


Command Modes

EXEC

Command History

Release
Modification

12.0(9)S

This command was introduced to support the Cisco 12000 series Internet router.

12.0(14)ST

This command was introduced to support the Cisco 12000 series Internet router.


Usage Guidelines

This command is available only on distributed switching platforms.

The type number argument display CEF status information for the specified interface type and number.

Examples

The following is sample output from the show cef interface policy-statistics command:

Router# show cef interface ethernet 1/0 policy-statistics

Ethernet1/0 is up (if_number 3)
  Corresponding hwidb fast_if_number 3
  Corresponding hwidb firstsw->if_number 3
 Index         Packets           Bytes
     1               0               0
     2               0               0
     3               0               0
     4               0               0
     5               0               0
     6               0               0
     7               0               0
     8               0               0

Table 8 describes the significant fields shown in the output.

Table 8 show cef interface policy-statistics Field Descriptions 

Field
Description

Index

Traffic index set with the route-map command.

Packts

Number of packets switched matching the index definition.

Bytes

Number of bytes switched matching the index definition.


Related Commands

Command
Description

show cef drop

Displays a list of which packets each line card dropped.

show cef linecard

Displays CEF-related interface information by line card.


show cef linecard

To display Cisco Express Forwarding (CEF)-related information by line card, use the show cef linecard command in EXEC mode.

show cef linecard [slot-number] [detail]

Syntax Description

slot-number

(Optional) Slot number containing the line card about which to display CEF-related information. When you omit this argument, information about all line cards is displayed.

detail

(Optional) Displays detailed CEF information for the specified line card.


Command Modes

EXEC

Command History

Release
Modification

11.2 GS

This command was introduced to support the Cisco 12012 Internet router.

11.1 CC

Multiple platform support was added.

12.0(10)S

Output display was changed.

12.1(2)T

This command was integrated into Cisco IOS Release 12.1(2)T.


Usage Guidelines

This command is available only on distributed switching platforms.

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 detail command for all line cards:

Router# show cef linecard detail

CEF linecard slot number 0, status up
 Sequence number 4, Maximum sequence number expected 28, Seq Epoch 2
 Send failed 0, Out Of Sequence 0, drops 0
 Linecard CEF reset 0, reloaded 1
 95 elements packed in 6 messages(3588 bytes) sent
 69 elements cleared
 linecard in sync after reloading
 0/0/0 xdr elements in LowQ/MediumQ/HighQ
 11/9/69 peak elements on LowQ/MediumQ/HighQ
 Input  packets 0, bytes 0
 Output packets 0, bytes 0, drops 0
 CEF Table statistics:
 Table name                Version Prefix-xdr Status
 Default-table                   7          4 Active, up, sync
CEF linecard slot number 1, status up
 Sequence number 4, Maximum sequence number expected 28, Seq Epoch 2
 Send failed 0, Out Of Sequence 0, drops 0
 Linecard CEF reset 0, reloaded 1
 95 elements packed in 6 messages(3588 bytes) sent
 69 elements cleared
 linecard in sync after reloading
 0/0/0 xdr elements in LowQ/MediumQ/HighQ
 11/9/69 peak elements on LowQ/MediumQ/HighQ
 Input  packets 0, bytes 0
 Output packets 0, bytes 0, drops 0
 CEF Table statistics:
 Table name                Version Prefix-xdr Status
 Default-table                   7          4 Active, up, sync

The following is sample output from the show cef linecard command. The command displays information for all line cards in table format.

Router# show cef linecard

Slot    MsgSent    XDRSent  Window   LowQ   MedQ  HighQ Flags
0             6         95      24      0      0      0 up
1             6         95      24      0      0      0 up
VRF Default-table, version 8, 6 routes
Slot Version    CEF-XDR    I/Fs State    Flags
0          7          4       8 Active   up, sync
1          7          4      10 Active   up, sync

Table 9 describes the significant fields shown in the displays.

Table 9 show cef linecard Field Descriptions 

Field
Description

Table name

Name of the CEF table.

Version

Number of forwarding information base (FIB) table version.

Prefix-xdr

Number of prefix XDRs processed.

Status

State of the CEF table.

Slot

Slot number of the line card.

MsgSent

Number of interprocess communication (IPC) messages sent.

XDRSent

IPC information elements (XDRs) packed into IPC messages sent from the RP to the line card.

Window

Size of the IPC window between the line card and RP.

LowQ/MedQ/HighQ

Number of XDR elements in the Low, Medium, and High priority queues.

Flags

Indicates the status of the line card. Possible states are the following:

up Line card is up.

sync Line card is in synchronization with the main FIB.

FIB is repopulated on the line card.

reset Line card FIB is reset.

reloading Line card FIB is being reloaded.

disabled Line card is disabled.

CEF-XDR

Number of CEF XDR messages processed.

I/Fs

Interface numbers.


Related Commands

Command
Description

show cef drop

Displays a list of which packets each line card dropped.

show cef interface

Displays CEF-related interface information.


show cef not-cef-switched

To display which packets were sent to a different switching path, use the show cef not-cef-switched command in user EXEC or privileged EXEC mode.

show cef not-cef-switched

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.2 GS

This command was introduced to support the Cisco 12012 Internet router.

11.1 CC

Multiple platform support was added.

12.0(22)S

The display output for this command was modified to include support for Cisco Express Forwarding for IPv6 (CEFv6) and distributed CEF for IPv6 (dCEFv6) packets.

12.0(23)S

This command was integrated into Cisco IOS Release 12.0(23)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T. Previously there was a show cef command, and drop was a keyword of that command.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.


Usage Guidelines

If packets are not being cef switched and you want to determine why, enter the show cef not-cef switched command.


Note If CEFv6 or dCEFv6 is enabled globally on the router, the show cef not-cef-switched command displays IPv6 CEF counter information and IPv4 CEF counter information. If CEFv6 or dCEFv6 is not enabled globally on the router, the command displays only IPv4 CEF counter information.


Examples

The following is sample output from the show cef not-cef switched command:

Router# show cef not-cef-switched 

CEF Packets passed on to next switching layer 
Slot No_adj No_encap Unsupp'ted Redirect  Receive  Options   Access    Frag
RP        0        0         0        0    91584        0        0       0
1         0        0         0        0        0        0        0       0
2         0        0         0        0        0        0        0       0
IPv6 CEF Packets passed on to next switching layer
Slot No_adj No_encap Unsupp'ted Redirect  Receive  Options   Access    MTU
RP        0        0         0        0    92784        0        0       0
1         0        0         0        0        0        0        0       0
2         0        0         0        0        0        0        0       0

Table 10 describes the significant fields shown in the display.

Table 10 show cef not-cef-switched Field Descriptions 

Field
Meaning

Slot

The slot number on which the packets were received.

No_adj

Indicates the number of packets sent to the processor due to incomplete adjacency.

No_encap

Indicates the number of packets sent to the processor for Address Resolution Protocol (ARP) resolution.

Unsupp'ted

Indicates the number of packets punted to the next switching level due to unsupported features.

Redirect

Records packets that are ultimately destined to the router, and packets destined to a tunnel endpoint on the router. If the decapsulated tunnel is IP, it is CEF switched; otherwise, packets are process switched.

Receive

Indicates the number of packets ultimately destined to the router, or packets destined to a tunnel endpoint on the router. If the decapsulated tunnel packet is IP, the packet is CEF switched. Otherwise, packets are process switched.

Options

Indicates the number of packets with options. Packets with IP options are handled only at the process level.

Access

Indicates the number of packets punted due to an access list failure.

Frag

Indicates the number of packets punted due to fragmentation failure.

Note This field is not supported for IPv6 packets.

MTU

Indicates the number of packets punted due to maximum transmission unit (MTU) failure.

Note This field is not supported for IPv4 packets.


Related Commands

Command
Description

show cef drop

Display a list of which packets each line card dropped.

show cef interface

Displays CEF-related interface information.

show ipv6 cef

Displays entries in the IPv6 FIB.


show cef timers

To display the current state of the timers internal to the CEF process, use the show cef timers command in user EXEC or privileged EXEC mode.

show cef timers

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.3(2)T

This command was introduced.


Examples

The following is sample output from the show cef timers command:

Router# show cef timers

CEF background process
     Expiration   Type
            0.208 (parent)
               0.208 adjacency update hwidb
               0.540 slow resolution
               1.208 ARP throttle

CEF FIB scanner process
     Expiration    Type
           44.852  (parent)
              44.852  checker scan-rib

Table 11 describes the significant fields shown in the display.

Table 11 show cef timers Field Descriptions 

Field
Description

Expiration

Seconds in which the timers will expire.

Type

Identification of the timer.


Related Commands

Command
Description

show cef interface

Displays CEF-related interface information.

show ipv6 cef

Displays entries in the IPv6 FIB.


show controllers vsi control-interface

To display information about an ATM interface configured with the tag-control-protocol vsi EXEC command to control an external switch (or if an interface is not specified, to display information about all VSI control interfaces), use the show controllers vsi control-interface command.

show controllers vsi control-interface [interface]

Syntax Description

interface

(Optional) Specifies the interface number.


Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.


Examples

The following is sample output from the show controllers vsi control-interface command:

Router# show controllers vsi control-interface

Interface:            ATM2/0        Connections:          14

The display shows the number of cross-connects currently on the switch that were established by the MPLS LSC through the VSI over the control interface.

Related Commands

Command
Description

tag-control-protocol vsi

Configures the use of VSI on a control port.


show controllers vsi descriptor

To display information about a switch interface discovered by the MPLS LSC through VSI, or if no descriptor is specified, about all such discovered interfaces, use the show controllers vsi descriptor EXEC command.

show controllers vsi descriptor [descriptor]

Syntax Description

descriptor

(Optional) Physical descriptor. For the Cisco BPX switch, the physical descriptor has the following form: slot.port.0


Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

Specify an interface by its (switch-supplied) physical descriptor.

Per-interface information includes the following:

Interface name

Physical descriptor

Interface status

Physical interface state (supplied by the switch)

Acceptable VPI and VCI ranges

Maximum cell rate

Available cell rate (forward/backward)

Available channels

Similar information is displayed when you enter the show controllers XTagATM EXEC command. However, you must specify a Cisco IOS interface name instead of a physical descriptor.

Examples

The following is sample output from the show controllers vsi descriptor command:

Router# show controllers vsi descriptor 12.2.0

Phys desc: 12.2.0
Log intf:  0x000C0200 (0.12.2.0)
Interface: XTagATM0
IF 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): 10000 

Table 12 describes the significant fields in the output.

Table 12 show controllers vsi descriptor Field Descriptions 

Field
Description

Phys desc

Physical descriptor. A string learned from the switch that identifies the interface.

Log intf

Logical interface ID. This 32-bit entity, learned from the switch, uniquely identifies the interface.

Interface

The (Cisco IOS) interface name.

IF status

Overall interface status. Can be "up," "down," or "administratively down."

Min VPI

Minimum virtual path identifier. Indicates the low end of the VPI range configured on the switch.

Max VPI

Maximum virtual path identifier. Indicates the high end of the VPI range configured on the switch.

Min VCI

Minimum virtual path identifier. Indicates the high end of the VPI range configured on the switch.

Max VCI

Maximum virtual channel identifier. Indicates the high end of the VCI range configured on, or determined by, the switch.

IFC state

Operational state of the interface, according to the switch. Can be one of the following:

FAILED_EXT (that is, an external alarm)

FAILED_INT (indicates the inability of the MPLS LSC to communicate with the VSI slave controlling the interface, or another internal failure)

REMOVED (administratively removed from the switch)

Maximum cell rate

Maximum cell rate for the interface, which has been configured on the switch (in cells per second).

Available channels

Indicates the number of channels (endpoints) that are currently free to be used for cross-connects.

Available cell rate (forward)

Cell rate that is currently available in the forward (that is, ingress) direction for new cross-connects on the interface.

Available cell rate (backward)

Cell rate that is currently available in the backward (that is, egress) direction for new cross-connects on the interface.


Related Commands

Command
Description

show controllers XTagATM

Displays information about an extended MPLS ATM interface.


show controllers vsi session

To display information about all sessions with VSI slaves, use the show controllers vsi session EXEC command.

show controllers vsi session [session-num [interface interface]]


Note A session consists of an exchange of VSI messages between the VSI master (the LSC) and a VSI slave (an entity on the switch). There can be multiple VSI slaves for a switch. On the BPX, each port or trunk card assumes the role of a VSI slave.


Syntax Description

session-num

(Optional) Specifies the session number.

interface interface

(Optional) Specifies the VSI control interface.


Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

If a session number and an interface are specified, detailed information on the individual session is presented. If the session number is specified, but the interface is omitted, detailed information on all sessions with that number is presented. (Only one session can contain a given number, because multiple control interfaces are not supported.)

Examples

The following is sample output from the show controllers vsi session command:

Router# show controllers vsi session 

Interface    Session  VCD    VPI/VCI    Switch/Slave Ids   Session State
   
ATM0/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               ESTABLISHED 

Table 13 describes the significant fields in the output.

Table 13 show controllers vsi session Field Descriptions 

Field
Description

Interface

Control interface name.

Session

Session number (from 0 to <n-1>), where n is the number of sessions on the control interface.

VCD

Virtual circuit descriptor (virtual circuit number). Identifies the VC carrying the VSI protocol between the master and the slave for this session.

VPI/VCI

Virtual path identifier or virtual channel identifier (for the VC used for this session).

Switch/Slave Ids

Switch and slave identifiers supplied by the switch.

Session State

Indicates the status of the session between the master and the slave.

ESTABLISHED is the fully operational steady state.

UNKNOWN indicates that the slave is not responding.

Other possible states include the following:

CONFIGURING

RESYNC_STARTING

RESYNC_UNDERWAY

RESYNC_ENDING

DISCOVERY

SHUTDOWN_STARTING

SHUTDOWN_ENDING

INACTIVE


In the following example, session number 9 is specified with the show controllers vsi session command:

Router# show controllers vsi session 9

Interface:            ATM1/0        Session number:       9
VCD:                  10            VPI/VCI:              0/49
Switch type:          BPX           Switch id:            0
Controller id:        1             Slave id:             10
Keepalive timer:      15            Powerup session id:   0x0000000A
Cfg/act retry timer:  8/8           Active session id:    0x0000000A
Max retries:          10            Ctrl port log intf:   0x000A0100
Trap window:          50            Max/actual cmd wndw:  21/21
Trap filter:          all           Max checksums:        19
Current VSI version:  1             Min/max VSI version:  1/1
Messages sent:        2502          Inter-slave timer:    4.000
Messages received:    2502          Messages outstanding: 0

Table 14 describes the significant fields in the output.

Table 14 show controllers vsi session Field Descriptions 

Field
Description

Interface

Name of the control interface on which this session is configured.

Session number

A number from 0 to <n-1>, where n is the number of slaves. Configured on the MPLS LSC with the slaves option of the tag-control-protocol vsi command.

VCD

Virtual circuit descriptor (virtual circuit number). Identifies the VC that carries VSI protocol messages for this session.

VPI/VCI

Virtual path identifier or virtual channel identifier for the VC used for this session.

Switch type

Switch device (for example, the BPX).

Switch id

Switch identifier (supplied by the switch).

Controller id

Controller identifier. Configured on the LSC, and on the switch, with the id option of the tag-control-protocol vsi command.

Slave id

Slave identifier (supplied by the switch).

Keepalive timer

VSI master keepalive timeout period (in seconds). Configured on the MPLS LSC through the keepalive option of the tag-control-protocol-vsi command. If no valid message is received by the MPLS LSC within this time period, it sends a keepalive message to the slave.

Powerup session id

Session ID (supplied by the slave) used at powerup time.

Cfg/act retry timer

Configured and actual message retry timeout period (in seconds). If no response is received for a command sent by the master within the actual retry timeout period, the message is resent. This applies to most message transmissions. The configured retry timeout value is specified through the retry option of the tag-control-protocol vsi command. The actual retry timeout value is the larger of the configured value and the minimum retry timeout value permitted by the switch.

Active session id

Session ID (supplied by the slave) for the currently active session.

Max retries

Maximum number of times that a particular command transmission will be retried by the master. That is, a message may be sent up to <max_retries+1> times. Configured on the MPLS LSC through the retry option of the tag-control-protocol vsi command.

Ctrl port log intf

Logical interface identifier for the control port, as supplied by the switch.

Trap window

Maximum number of outstanding trap messages permitted by the master. This is advertised, but not enforced, by the LSC.

Max/actual cmd wndw

Maximum command window is the maximum number of outstanding (that is, unacknowledged) commands that may be sent by the master before waiting for acknowledgments. This number is communicated to the master by the slave.

The command window is the maximum number of outstanding commands that are permitted by the master, before it waits for acknowledgments. This is always less than the maximum command window.

Trap filter

This is always "all" for the LSC, indicating that it wants to receive all traps from the slave. This is communicated to the slave by the master.

Max checksums

Maximum number of checksum blocks supported by the slave.

Current VSI version

VSI protocol version currently in use by the master for this session.

Min/max VSI version

Minimum and maximum VSI versions supported by the slave, as last reported by the slave. If both are zero, the slave has not yet responded to the master.

Messages sent

Number of commands sent to the slave.

Inter-slave timer

Timeout value associated by the slave for messages it sends to other slaves.

On a VSI-controlled switch with a distributed slave implementation (such as the BPX), VSI messages may be sent between slaves to complete their processing.

For the MPLS LSC VSI implementation to function properly, the value of its retry timer is forced to be at least two times the value of the interslave timer. (See "Cfg/act retry timer" in this table.)

Messages received

Number of responses and traps received by the master from the slave for this session.

Messages outstanding

Current number of outstanding messages (that is, commands sent by the master for which responses have not yet been received).


Related Commands

Command
Description

tag-control-protocol vsi

Configures the use of VSI on a control port.


show controllers vsi status

To display a one-line summary of each VSI-controlled interface, use the show controllers vsi status EXEC command.

show controllers vsi status

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Related Commands

EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

If an interface has been discovered by the LSC, but no extended MPLS 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:

Router# show controllers vsi status

Interface 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.0 

Table 15 describes the significant fields in the output.

Table 15 show controllers vsi status Field Descriptions 

Field
Description

Interface Name

The (Cisco IOS) interface name.

IF Status

Overall interface status. Can be "up," "down," or "administratively down."

IFC State

The operational state of the interface, according to the switch. Can be one of the following:

FAILED_EXT (that is, an external alarm)

FAILED_INT (indicates the inability of the MPLS LSC to communicate with the VSI slave controlling the interface, or another internal failure)

REMOVED (administratively removed from the switch)

Physical Descriptor

A string learned from the switch that identifies the interface.


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 EXEC command.

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 a session number.

vc

(Optional) Virtual circuit.

vpi

(Optional) Virtual path identifier.

vci

(Optional) Virtual circuit identifier.


Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.


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 EXEC command.

Examples

The following is sample output from the show controllers vsi traffic command:

Router# show controllers vsi traffic

Phys desc: 10.1.0
Interface: switch control port
IF status: n/a
Rx cells: 304250             Rx cells discarded: 0
Tx cells: 361186             Tx cells discarded: 0
Rx header errors: 4294967254 Rx invalid addresses (per card): 80360
Last invalid address: 0/53
          
Phys desc: 10.2.0
Interface: XTagATM0
IF status: up
Rx cells: 202637             Rx cells discarded: 0
Tx cells: 194979             Tx cells discarded: 0
Rx header errors: 4294967258 Rx invalid addresses (per card): 80385
Last invalid address: 0/32
          
Phys desc: 10.3.0
Interface: XTagATM1
IF status: up
Rx cells: 182295             Rx cells discarded: 0
Tx cells: 136369             Tx cells discarded: 0
Rx header errors: 4294967262 Rx invalid addresses (per card): 80372
Last invalid address: 0/32

Table 16 describes the significant fields in the output.

Table 16 show controllers vsi traffic Field Descriptions 

Field
Description

Phys desc

Physical descriptor of the interface.

Interface

The (Cisco IOS) interface name.

Rx cells

Number of cells received on the interface.

Tx cells

Number of cells sent on the interface.

Rx cells discarded

Number of cells received on the interface that were discarded due to traffic management.

Tx cells discarded

Number of cells that could not be sent on the interface due to traffic management and that were therefore discarded.

Rx header errors

Number of cells that were discarded due to ATM header errors.

Rx invalid addresses

Number of cells received with an invalid address (that is, an unexpected VPI/VCI combination). With the Cisco BPX switch, this count is of all such cells received on all interfaces in the port group of this interface.

Last invalid address

Number of cells received on this interface with ATM cell header errors.


The following sample output is displayed when you enter the show controllers vsi traffic session 9 command:

Router# show controllers vsi traffic session 9
                        Sent                                Received
Sw Get Cnfg Cmd:         3656       Sw Get Cnfg Rsp:         3656      
Sw Cnfg Trap Rsp:        0          Sw Cnfg Trap:            0         
Sw Set Cnfg Cmd:         1          Sw Set Cnfg Rsp:         1         
Sw Start Resync Cmd:     1          Sw Start Resync Rsp:     1         
Sw End Resync Cmd:       1          Sw End Resync Rsp:       1         
Ifc Getmore Cnfg Cmd:    1          Ifc Getmore Cnfg Rsp:    1         
Ifc Cnfg Trap Rsp:       4          Ifc Cnfg Trap:           4         
Ifc Get Stats Cmd:       8          Ifc Get Stats Rsp:       8         
Conn Cmt Cmd:            73         Conn Cmt Rsp:            73        
Conn Del Cmd:            50         Conn Del Rsp:            0         
Conn Get Stats Cmd:      0          Conn Get Stats Rsp:      0         
Conn Cnfg Trap Rsp:      0          Conn Cnfg Trap:          0         
Conn Bulk Clr Stats Cmd: 0          Conn Bulk Clr Stats Rsp: 0         
Gen Err Rsp:             0          Gen Err Rsp:             0         
unused:                  0          unused:                  0         
unknown:                 0          unknown:                 0         
TOTAL:                   3795       TOTAL:                   3795      

Table 17 describes the significant fields in the output.

Table 17 show controllers vsi traffic session Field Descriptions 

Field
Description

Sw Get Cnfg Cmd

Number of VSI "get switch configuration command" messages sent.

Sw Cnfg Trap Rsp

Number of VSI "switch configuration asynchronous trap response" messages sent.

Sw Set Cnfg Cmd

Number of VSI "set switch configuration command" messages sent.

Sw Start Resync Cmd

Number of VSI "set resynchronization start command" messages sent.

Sw End Resync Cmd

Number of VSI "set resynchronization end command" messages sent.

Ifc Getmore Cnfg Cmd

Number of VSI "get more interfaces configuration command" messages sent.

Ifc Cnfg Trap Rsp

Number of VSI "interface configuration asynchronous trap response" messages sent.

Ifc Get Stats Cmd

Number of VSI "get interface statistics command" messages sent.

Conn Cmt Cmd

Number of VSI "set connection committed command" messages sent.

Conn Del Cmd

Number of VSI "delete connection command" messages sent.

Conn Get Stats Cmd

Number of VSI "get connection statistics command" messages sent.

Conn Cnfg Trap Rsp

Number of VSI "connection configuration asynchronous trap response" messages sent.

Conn Bulk Clr Stats Cmd

Number of VSI "bulk clear connection statistics command" messages sent.

Gen Err Rsp

Number of VSI "generic error response" messages sent or received.

Sw Get Cnfg Rsp

Number of VSI "get connection configuration command response" messages received.

Sw Cnfg Trap

Number of VSI "switch configuration asynchronous trap" messages received.

Sw Set Cnfg Rsp

Number of VSI "set switch configuration response" messages received.

Sw Start Resync Rsp

Number of VSI "set resynchronization start response" messages received.

Sw End Resync Rsp

Number of VSI "set resynchronization end response" messages received.

Ifc Getmore Cnfg Rsp

Number of VSI "get more interfaces configuration response" messages received.

Ifc Cnfg Trap

Number of VSI "interface configuration asynchronous trap" messages received.

Ifc Get Stats Rsp

Number of VSI "get interface statistics response" messages received.

Conn Cmt Rsp

Number of VSI "set connection committed response" messages received.

Conn Del Rsp

Number of VSI "delete connection response" messages received.

Conn Get Stats Rsp

Number of VSI "get connection statistics response" messages received.

Conn Cnfg Trap

Number of VSI "connection configuration asynchronous trap" messages received.

Conn Bulk Clr Stats Rsp

Number of VSI "bulk clear connection statistics response" messages received.

unused, unknown

"Unused" messages are those whose function codes are recognized as being part of the VSI protocol, but that are not used by the MPLS LSC and, consequently, are not expected to be received or sent.

"Unknown" messages have function codes that the MPLS LSC does not recognize as part of the VSI protocol.

TOTAL

Total number of VSI messages sent or received.


show controllers XTagATM

To display information about an extended MPLS ATM interface controlled through the VSI protocol (or, if an interface is not specified, to display information about all extended MPLS ATM interfaces controlled through the VSI protocol), use the show controllers XTagATM EXEC command.

show controllers XTagATM if-num

Syntax Description

if-num

Specifies the interface number.


Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.


Usage Guidelines

Per-interface information includes the following:

Interface name

Physical descriptor

Interface status

Physical interface state (supplied by the switch)

Acceptable VPI and VCI ranges

Maximum cell rate

Available cell rate (forward/backward)

Available channels

Similar information appears if you enter the show controllers vsi descriptor EXEC command. However, you must specify an interface by its (switch-supplied) physical descriptor, instead of its Cisco IOS interface name. For the Cisco BPX switch, 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:

Router# show controllers XTagATM 0

Interface 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: 0

Table 18 describes the significant fields in the output.

Table 18 show controllers XTagATM Field Descriptions 

Field
Description

Interface XTagATM0 is up

Indicates the overall status of the interface. May be "up," "down," or "administratively down."

Hardware is Tag-Controlled ATM Port

Indicates the hardware type.

If the XTagATM was successfully associated with a switch port, a description of the form (on <switch_type> switch <name>) follows this field, where <switch_type> indicates the type of switch (for example, BPX), and the name is an identifying string learned from the switch.

If the XTagATM interface was not bound to a switch interface (with the extended-port interface configuration command), then the label "Not bound to a control interface and switch port" appears.

If the interface has been bound, but the target switch interface has not been discovered by the LSC, then the label "Bound to undiscovered switch port (id <number>)" appears, where <number> is the logical interface ID in hexadecimal notation.

Control interface ATM1/0 is up

Indicates that the XTagATM interface was bound (with the extended-port interface configuration command) to the VSI master whose control interface is ATM1/0 and that this control interface is up.

Physical descriptor is...

A string identifying the interface that was learned from the switch.

Logical interface

This 32-bit entity, learned from the switch, uniquely identifies the interface. It appears in both hexadecimal and dotted quad notation.

Oper state

Operational state of the interface, according to the switch. Can be one of the following:

ACTIVE

FAILED_EXT (that is, an external alarm)

FAILED_INT (indicates the inability of the MPLS LSC to communicate with the VSI slave controlling the interface, or another internal failure)

REMOVED (administratively removed from the switch)

admin state

Administrative state of the interface, according to the switch—either "Up" or "Down."

VPI range 1 to 255

Indicates the allowable VPI range for the interface that was configured on the switch.

VCI range 32 to 65535

Indicates the allowable VCI range for the interface that was configured on, or determined by, the switch.

LSC control VC need not be strictly in VPI or VCI range

Indicates that the label control VC does not need to be within the range specified by VPI range, but may be on VPI 0 instead.

Available channels

Indicates the number of channels (endpoints) that are currently free to be used for cross-connects.

Maximum cell rate

Maximum cell rate for the interface, which was configured on the switch.

Available cell rate

Cell rate that is currently available for new cross-connects on the interface.

Endpoints in use

Number of endpoints (channels) in use on the interface, broken down by anticipated traffic flow, as follows:

Ingress—Endpoints carry traffic into the switch

Egress—Endpoints carry traffic away from the switch

Ingress/egress—Endpoints carry traffic in both directions

Rx cells

Number of cells received on the interface.

rx cells discarded

Number of cells received on the interface that were discarded due to traffic management actions (rx header errors).

rx header errors

Number of cells received on the interface with cell header errors.

rx invalid addresses (per card)

Number of cells received with invalid addresses (that is, unexpected VPI or VCI.). On the BPX, this counter is maintained per port group (not per interface).

last invalid address

Address of the last cell received on the interface with an invalid address (for example, 0/32).

Tx cells

Number of cells sent from the interface.

tx cells discarded

Number of cells intended for transmission from the interface that were discarded due to traffic management actions.


Related Commands

Command
Description

show controllers vsi descriptor

Displays information about a switch interface discovered by the MPLS LSC through the VSI.


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

type number

Interface type and number about which to display statistics.


Command Modes

EXEC

Command History

Release
Modification

11.0

This command was introduced.


Usage Guidelines

Use this command on the RP.


Note When fast switching is configured on the outbound interface, and RSP optimum, RSP flow, and VIP DFS switching modes are all specified on the incoming interface, the interface on which RSP optimum, RSP flow, and VIP DFS switching modes is not enabled can still show packets switched out via those switching paths when packets are received from other interfaces with RSP optimum, RSP flow, and VIP DES switching modes enabled.


Examples

The following is sample output from the show interface stats command:

Router# show interface fddi 3/0/0 stats 

Fddi3/0/0
          Switching path    Pkts In   Chars In   Pkts Out  Chars Out
               Processor    3459994 1770812197    4141096 1982257456
             Route cache   10372326 3693920448     439872  103743545
       Distributed cache   19257912 1286172104   86887377 1184358085
                   Total   33090232 2455937453   91468345 3270359086

Table 19 describes the significant fields in the display.

Table 19 show interface stats Field Descriptions 

Field
Description

Fddi3/0/0

Interface for which information is shown.

Switching path

Column heading for the various switching paths below it.

Pkts In

Number of packets received in each switching mechanism.

Chars In

Number of characters received in each switching mechanism.

Pkts Out

Number of packets sent out each switching mechanism.

Chars Out

Number of characters sent out each switching mechanism.