-
Catalyst 6500 Series Command Reference, 7.6
-
Quick Links to Catalyst 6500 Series Switch and ROM Monitor Commands
-
Index
-
Preface
-
Command-Line Interfaces
-
alias to boot
-
cd to clear mls exclude protocol
-
clear mls multicast statistics to clear vtp pruneeligible
-
clear vtp statistics to disable
-
disconnect to enable
-
Format to Ping
-
pwd to reset-switch
-
restore counters to set crypto key rsa
-
set default portstatus to set logging timestamp
-
set logout to set port arp-inspection
-
set port auxiliaryvlan to set rcp username
-
set rgmp to set spantree portvlanpri
-
set spantree priority to set trunk
-
set udld to set vtp pruneeligible
-
show accounting to show dot1q-all-tagged
-
show dot1x to show ip alias
-
show ip dns to show ip permit
-
show ip route to show pbf-map
-
show port to show snmp
-
show snmp access to show tech-support
-
show test to show users
-
show version to squeeze
-
stack to write tech-support
-
Acronyms
-
Table Of Contents
show spantree portinstancecost
22show snmp access
To display SNMP access information, use the show snmp access command.
show snmp access [volatile | nonvolatile | read-only]
show snmp access [-hex] groupname security-model {v1 | v2c}
show snmp access [-hex] groupname security-model v3 {noauthentication | authentication | privacy} [context [-hex] contextname]
Syntax Description
Defaults
The default storage type is volatile.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the groupname (nonprintable delimiters for these parameters), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
If you do not enter a context name, a NULL context string is used.
There are three versions of SNMP:
•
Version 1 (SNMPv1)—This is the initial implementation of SNMP. Refer to RFC 1157 for a full description of functionality.
•
•
The SNMP functionality on the Catalyst enterprise LAN switches for SNMP v1 and SNMP v2c remains intact; however, the functionality has greatly expanded for SNMPv3. Refer to the "Configuring SNMP" chapter of the Catalyst 6500 Series Switch Software Configuration Guide for more information on SNMPv3.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display all SNMP access information:
Console> (enable) show snmp accessGroup Name:defaultROgroupContext:Security Model:v1Security Level:noauthenticationContext Match:vlan-1Read View:defaultAdminViewWrite View:Notify View:defaultAdminViewStorage Type:read-onlyRow Status:activeGroup Name:defaultROgroupContext:Security Model:v2cSecuirty Level:noauthenticationContext Match:vlan-55Read View:defaultAdminViewWrite View:Notify View:defaultAdminViewStorage Type:read-onlyRow Status:activeRelated Commands
clear snmp access
set snmp access
show snmp contextshow snmp access-list
To display SNMP access list numbers and corresponding IP addresses and IP masks, use the show snmp access-list command.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display SNMP access list numbers and corresponding IP addresses and IP masks:
Console> show snmp access-listAccess-Number IP-Addresses/IP-Mask------------- -------------------------1 172.20.60.100/255.0.0.01.1.1.1/-2 172.20.60.7/-2.2.2.2/-3 2.2.2.2/155.0.0.04 1.1.1.1/2.1.2.42.2.2.2/-2.2.2.5/-Related Commands
clear snmp access-list
set snmp access-listshow snmp buffer
To display the number of SNMP packets that can be saved in the SNMP UDP socket receive buffer, use the show snmp buffer command.
show snmp buffer
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display the number of SNMP socket packets that can be saved in the SNMP UDP socket receive buffer:
Console> show snmp bufferSNMP socket receive buffer:40 packetsConsole>Related Commands
show snmp community
To display SNMP context information, use the show snmp community command.
show snmp community
show snmp community [read-only | volatile | nonvolatile]
show snmp community index [-hex] {index name}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal and privileged.
Usage Guidelines
If you enter the show snmp community command in privileged mode, the output display includes information for the read-only, the read-write, and the read-write-all community strings. If you enter the show snmp community command in normal mode, the display includes only information for the read-only community string.
Examples
This example shows the output when you enter the show snmp community command for the read-only community string in normal mode:
Console> show snmp communityCommunity Index: sysCommunityRo.0Community Name: publicSecurity Name: publicContext Name:Transport Tag:Storage Type: read-onlyRow Status: activeConsole>This example shows the display output when you enter the show snmp community command for the read-only, the read-write, and the read-write-all community strings in privileged mode:
Console> (enable) show snmp communityCommunity Index: sysCommunityRo.0Community Name: publicSecurity Name: publicContext Name:Transport Tag:Storage Type: read-onlyRow Status: activeCommunity Index: sysCommunityRw.0Community Name: privateSecurity Name: privateContext Name:Transport Tag:Storage Type: read-onlyRow Status: activeCommunity Index: sysCommunityRwa.0Community Name: secretSecurity Name: secretContext Name:Transport Tag:Storage Type: read-onlyRow Status: activeConsole> (enable)Related Commands
clear snmp community
set snmp communityshow snmp context
To display SNMP context information, use the show snmp context command.
show snmp context
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display SNMP context information:
Console> (enable) show snmp contextIndex Context----- --------01 vlan-12 vlan-553 vlan-10024 vlan-10035 vlan-10046 vlan-1005Console> (enable)Related Commands
clear snmp access
set snmp access
show snmp accessshow snmp counters
To display SNMP counter information, use the show snmp counters command.
show snmp counters [v3 | {{mod/port} {dot1d | dot3 | hcrmon | ifmib | rmon}}]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal
Usage Guidelines
There are three versions of SNMP:
•
•
•
The SNMP functionality on the Catalyst enterprise LAN switches for SNMP v1 and SNMP v2c remains intact; however, the functionality has greatly expanded for SNMPv3. Refer to the "Configuring SNMP" chapter of the Catalyst 6500 Series Switch Software Configuration Guide for more information on SNMPv3.
Examples
This example shows how to display all SNMP counters:
Console> show snmp countersmib2 SNMP group counters:snmpInPkts = 13993snmpOutPkts = 13960snmpInBadVersions = 0snmpInBadCommunityNames = 33snmpInBadCommunityUses = 0snmpInASNParseErrs = 0snmpInTooBigs = 0snmpInNoSuchNames = 0snmpInBadValues = 0snmpInReadOnlys = 0snmpInGenErrs = 0snmpInTotalReqVars = 61747snmpInTotalSetVars = 0snmpInGetRequests = 623snmpInGetNexts = 13337snmpInSetRequests = 0snmpInGetResponses = 0snmpInTraps = 0snmpOutTooBigs = 0snmpOutNoSuchNames = 230snmpOutBadValues = 0snmpOutGenErrs = 0snmpOutGetRequests = 0snmpOutGetNexts = 0snmpOutSetRequests = 0snmpOutGetResponses = 13960snmpOutTraps = 0Console>Table 2-77 describes the fields in the show snmp counters command output.
Table 2-77 show snmp counters Command Output Fields
snmpInPkts
Number of messages delivered to the SNMP entity from the transport service.
snmpOutPkts
Number of SNMP messages passed from the SNMP protocol entity to the transport service.
snmpInBadVersions
Number of SNMP messages delivered to the SNMP entity for an unsupported SNMP version.
snmpInBadCommunityNames
Number of SNMP messages delivered to the SNMP entity that used an SNMP community name not known to said entity.
snmpInBadCommunityUses
Number of SNMP messages delivered to the SNMP entity that represented an SNMP operation not allowed by the SNMP community named in the message.
snmpInASNParseErrs
Number of ASN.1 or BER errors encountered by the SNMP entity when decoding received SNMP messages.
snmpInTooBigs
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "tooBig."
snmpInNoSuchNames
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "noSuchName."
snmpInBadValues
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "badValue."
snmpInReadOnlys1
Number of valid SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "readOnly."
snmpInGenErrs
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "genErr."
snmpInTotalReqVars
Number of MIB objects retrieved successfully by the SNMP protocol entity as the result of receiving valid SNMP Get-Request and Get-Next PDUs.
snmpInTotalSetVars
Number of MIB objects altered successfully by the SNMP protocol entity as the result of receiving valid SNMP Set-Request PDUs.
snmpInGetRequests
Number of SNMP Get-Request PDUs accepted and processed by the SNMP protocol entity.
snmpInPkts
Number of messages delivered to the SNMP entity from the transport service.
snmpOutPkts
Number of SNMP messages passed from the SNMP protocol entity to the transport service.
snmpInBadVersions
Number of SNMP messages delivered to the SNMP entity for an unsupported SNMP version.
snmpInBadCommunityNames
Number of SNMP messages delivered to the SNMP entity that used an SNMP community name not known to said entity.
snmpInBadCommunityUses
Number of SNMP messages delivered to the SNMP entity that represented an SNMP operation not allowed by the SNMP community named in the message.
snmpInASNParseErrs
Number of ASN.1 or BER errors encountered by the SNMP entity when decoding received SNMP messages.
snmpInTooBigs
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "tooBig."
snmpInNoSuchNames
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "noSuchName."
snmpInBadValues
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "badValue."
snmpInGenErrs
Number of SNMP PDUs delivered to the SNMP protocol entity with the value of the error-status field as "genErr."
snmpInTotalReqVars
Number of MIB objects retrieved successfully by the SNMP protocol entity as the result of receiving valid SNMP Get-Request and Get-Next PDUs.
snmpInTotalSetVars
Number of MIB objects altered successfully by the SNMP protocol entity as the result of receiving valid SNMP Set-Request PDUs.
snmpInGetRequests
Number of SNMP Get-Request PDUs accepted and processed by the SNMP protocol entity.
snmpInGetNexts
Number of SNMP Get-Next PDUs accepted and processed by the SNMP protocol entity.
snmpInSetRequests
Number of SNMP Set-Request PDUs accepted and processed by the SNMP protocol entity.
snmpInGetResponses
Number of SNMP Get-Response PDUs accepted and processed by the SNMP protocol entity.
snmpInTraps
Number of SNMP Trap PDUs accepted and processed by the SNMP protocol entity.
snmpOutTooBigs
Number of SNMP PDUs generated by the SNMP protocol entity with the value of the error-status field as "tooBig."
snmpOutNoSuchNames
Number of SNMP PDUs generated by the SNMP protocol entity with the value of the error-status as "noSuchName."
snmpOutBadValues
Number of SNMP PDUs generated by the SNMP protocol entity with the value of the error-status field as "badValue."
snmpOutGenErrs
Number of SNMP PDUs generated by the SNMP protocol entity with the value of the error-status field as "genErr."
snmpOutGetRequests
Number of SNMP Get-Request PDUs generated by the SNMP protocol entity.
snmpOutGetNexts
Number of SNMP Get-Next PDUs generated by the SNMP protocol entity.
snmpOutSetRequests
Number of SNMP Set-Request PDUs generated by the SNMP protocol entity.
snmpOutGetResponses
Number of SNMP Get-Response PDUs generated by the SNMP protocol entity.
snmpOutTraps
Number of SNMP Trap PDUs generated by the SNMP protocol entity.
1 It is a protocol error to generate an SNMP PDU that contains the value "readOnly" in the error-status field. This object is provided as a means of detecting incorrect implementations of the SNMP.
1 This example shows how to display the SNMPv3 counters:
1 Console> show snmp counters v31 snmpv3 MPD statistics:1 snmpUnknownSecurityModels = 01 snmpInvalidMsgs = 01 snmpUnknownPDUHandlers = 01 snmpv3 TARGET statistics:1 snmpUnavailableContexts = 01 snmpUnknownContexts = 01 snmpv3 USM statistics:1 usmStatsUnsupportedSecLevels = 01 usmStatsNotInTimeWindows = 01 usmStatsUnknownUserNames = 01 usmStatsUnknownEngineIDs = 01 usmStatsWrongDigests = 01 usmStatsDecryptionErrors = 01 Console>
show snmp engineid
To display the SNMP local engine ID, use the show snmp engineid command.
show snmp engineid
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If the SNMP engine ID is cleared, the system automatically regenerates a local SNMP engine ID.
The SNMP engine and the SNMP entity have a one-to-one mapping. You can also identify the SNMP entity, which is represented as hexadecimal numbers only, and must be from 5 to 32 bytes long; for example, 00:00:00:09:0a:fe:ff:12:97:33:45:12.
Examples
This example shows how to display the SNMP engine ID:
Console> (enable) show snmp engineidEngineId: 00:00:00:09:00:d0:00:4c:18:00Engine Boots: 1234455Console> (enable)Table 2-78 describes the fields in the show snmp engineid command output.
Related Commands
show snmp group
To display the name of the SNMP group or collection of users who have a common access policy, use the show snmp group command.
show snmp group [volatile | nonvolatile | read-only]
show snmp group [-hex] {groupname} [-hex] user {username}
[security-model {v1 | v2c | v3}]Syntax Description
Defaults
The default storage type is volatile.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the groupname and username (nonprintable delimiters for these parameters), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
There are three versions of SNMP:
•
•
•
The SNMP functionality on the Catalyst enterprise LAN switches for SNMP v1 and SNMP v2c remains intact; however, the functionality has greatly expanded for SNMPv3. Refer to the "Configuring SNMP" chapter of the Catalyst 6500 Series Switch Software Configuration Guide for more information on SNMPv3.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display the SNMP group:
Console> (enable) show snmp groupSecurity Model: v1Security Name: publicGroup Name: defaultROgroupStorage Type: volatileRow Status: activeSecurity Model: v1Security Name: secretGroup Name: defaultRWALLgroupStorage Type: volatileRow Status: activeSecurity Model: v1Security Name: privateGroup Name: defaultRWgroupStorage Type: volatileRow Status: activeSecurity Model: v2cSecurity Name: publicGroup Name: defaultROgroupStorage Type: volatileRow Status: activeConsole> (enable)Table 2-79 describes the fields in the show snmp group command output.
Related Commands
clear snmp group
set snmp groupshow snmp ifalias
To display SNMP interface aliases, use the show snmp ifalias command.
show snmp ifalias [ifIndex]
show snmp ifalias module mod
show snmp ifalias vlan [vlan]
show snmp ifalias channel
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you do not enter an interface index number, all interface aliases are displayed.
Related Commands
clear snmp ifalias
set snmp ifaliasshow snmp notify
To display the snmpNotifyTable configuration, use the show snmp notify command.
show snmp notify [volatile | nonvolatile | read-only]
show snmp notify [-hex] {notifyname}
Syntax Description
Defaults
The default storage type is nonvolatile.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the notifyname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display the SNMP notify information for a specific notifyname value:
Console> (enable) show snmp notify snmpV1NotificationNotify Name: snmpV1NotificationNotify Tag: snmpV1TrapNotify Type: trapStorage Type: volatileRow Status: activeConsole> (enable)Table 2-80 describes the fields in the show snmp notify command output.
Related Commands
clear snmp notify
set snmp notifyshow snmp rmonmemory
To display the memory usage limit in percentage, use the show snmp rmonmemory command.
show snmp rmonmemory
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The percentage value displayed indicates that you cannot create new RMON entries or restore entries from the NVRAM if the specified memory usage is exceeded.
Examples
This example shows how to display the RMON memory limit use:
Console> (enable) show snmp rmonmemory85 percentConsole> (enable)Related Commands
show snmp targetaddr
To display the SNMP target address entries in the snmpTargetAddressTable, use the show snmp targetaddr command.
show snmp targetaddr [volatile | nonvolatile | read-only]
show snmp targetaddr [-hex] {addrname}
Syntax Description
Defaults
The default storage type is nonvolatile.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the addrname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display specific target address information in the snmpTargetAddressTable:
Console> (enable) show snmp targetaddr ciscoTarget Address Name: ciscoIP Address: 170.0.25.1UDP Port#: 165Timeout: 100Retry count: 5Tag List: tag1 tag2 tag3Parameters: jeorgeStorage Type: nonvolatileRow Status: activeConsole> (enable)Table 2-81 describes the fields in the show snmp targetaddr command output.
Related Commands
clear snmp targetaddr
set snmp targetaddrshow snmp targetparams
To display the SNMP parameters used in the snmpTargetParamsTable when generating a message to a target, use the show snmp targetparams command.
show snmp targetparams [volatile | nonvolatile | read-only]
show snmp targetparams [-hex] {paramsname}
Syntax Description
Defaults
The default storage type is volatile.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the paramsname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display specific target parameter information in the snmpTargetParamsTable:
Console> (enable) show snmp targetparams snmpV1TrapParamsTarget Parameter Name: snmpV1TrapParamsMessage Processing Model: v1Security Name: publicSecurity Level: noauthenticationStorage Type: volatileRow Status: activeConsole> (enable)Table 2-82 describes the fields in the show snmp targetparams command output.
Related Commands
clear snmp targetparams
set snmp targetparamsshow snmp user
To display SNMP information for a specific user, use the show snmp user command.
show snmp user [volatile | nonvolatile | read-only]
show snmp user [-hex] {user} [remote {engineid}]
show snmp user summary
Syntax Description
Defaults
The default storage type is nonvolatile, and the local SNMP engine ID is used.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the user value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display specific user information:
Console> (enable) show snmp user joeEngineId: 00:11:22:33:44User Name: joeAuthentication Protocol: md5Privacy Protocol: des56Storage Type: volatileRow Status: activeConsole> (enable)Table 2-83 describes the fields in the show snmp user command output.
Related Commands
show snmp view
To display the SNMP MIB view configuration, use the show snmp view command.
show snmp view [volatile | nonvolatile | read-only]
show snmp view [-hex] {viewname} {subtree}
Syntax Description
Defaults
The default view is volatile.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
If you use special characters for the viewname value (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
A MIB subtree used with a mask defines a view subtree; it can be in OID format or a text name mapped to a valid OID.
The read-only keyword is supported for security model v3 only.
Examples
This example shows how to display the SNMP MIB view:
Console> (enable) show snmp viewView Name: defaultUserViewSubtree OID: 1.3.6.1Subtree Mask:View Type: includedStorage Type: volatileRow Status: activeControl> (enable)Table 2-84 describes the fields in the show snmp view command output.
Related Commands
show span
To display information about the current SPAN configuration, use the show span command.
show span [all]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display SPAN information for the switch. In this example, the SPAN source is port 2/1 and the SPAN destination is port 2/12. Only transmit traffic is monitored. Normal incoming packets are disabled on the SPAN destination port. Monitoring multicast traffic is enabled.
Console> (enable) show span----------------------------------------------------------Destination : Port 4/1Admin Source : Port 2/2Oper Source : Port 2/2Direction : transmit/receiveIncoming Packets: enabledLearning : -Multicast : enabledFilter : 10,20,30,40,50,60,70,80,90,100Status : inactiveConsole> (enable)Table 2-85 describes the fields in the show span command output.