-
Cisco IOS IP Application Services Command Reference
-
Introduction
-
carrier-delay (tracking) through forwarding-agent
-
ip accounting through ip sctp authenticate
-
ip tcp adjust-mss through ipv6 tcp adjust-mss
-
mls ip install-threshold through platform trace runtime process forwarding-manager module wccp
-
sctp through show ip sctp statistics
-
show ip sockets through show sockets
-
show tcp through start-forwarding agent
-
threshold metric through track timer
-
Index
-
Feedback
Contents
show ip sockets through show sockets
- show ip sockets
- show ip tcp header-compression
- show ip traffic
- show ip wccp
- show ip wccp global counters
- show ip wccp web-caches
- show platform hardware qfp active feature wccp
- show platform software wccp
- show sctp association
- show sctp association list
- show sctp association parameters
- show sctp association statistics
- show sctp errors
- show sctp instance
- show sctp instances
- show sctp statistics
- show sockets
show ip sockets
To display IP socket information, use the show ip sockets command in user EXEC or privileged EXEC mode.
Command History
Release
Modification
10.0 T
This command was introduced.
12.2(2)T
Support for IPv6 socket information in the display output of the command was added.
12.0(21)ST
This command was integrated into Cisco IOS Release 12.0(21)ST.
12.0(22)S
This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(11)T
This command was replaced by the show udp, show sockets and show ip sctp commands.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
Usage Guidelines
Use this command to verify that the socket being used is opening correctly. If there is a local and remote endpoint, a connection is established with the ports indicated.
Examples
The following is sample output from the show ip sockets command:
Router# show ip sockets Proto Remote Port Local Port In Out Stat TTY OutputIF 17 10.0.0.0 0 172.16.186.193 67 0 0 1 0 17 172.16.191.135 514 172.16.191.129 1811 0 0 0 0 17 172.16.135.20 514 172.16.191.1 4125 0 0 0 0 17 172.16.207.163 49 172.16.186.193 49 0 0 9 0 17 10.0.0.0 123 172.16.186.193 123 0 0 1 0 88 10.0.0.0 0 172.16.186.193 202 0 0 0 0 17 172.16.96.59 32856 172.16.191.1 161 0 0 1 0 17 --listen-- --any-- 496 0 0 1 0The following sample output from the show ip sockets command shows IPv6 socket information:
Router# show ip sockets Proto Remote Port Local Port In Out Stat TTY OutputIF 17(v6) --listen-- --any-- 1024 0 0 0 0 17(v6) --listen-- --any-- 7 0 0 0 0 17(v6) --listen-- --any-- 161 0 0 0 0 17(v6) --listen-- --any-- 162 0 0 0 0 17 --listen-- --any-- 1024 0 0 0 0 17 --listen-- --any-- 7 0 0 0 0 17 --listen-- --any-- 9 0 0 0 0 17 --listen-- --any-- 19 0 0 0 0 17 --listen-- --any-- 1645 0 0 0 0 17 --listen-- --any-- 1646 0 0 0 0 17 --listen-- --any-- 161 0 0 0 0 17 --listen-- --any-- 162 0 0 0 0The table below describes the significant fields shown in the display.
Table 1 show ip sockets Field Descriptions Field
Description
Proto
Protocol type, for example, User Datagram Protocol (UDP) or TCP.
Remote
Remote address connected to this networking device. If the remote address is considered illegal, “--listen--” is displayed.
Port
Remote port. If the remote address is considered illegal, “--listen--” is displayed.
Local
Local address. If the local address is considered illegal or is the address 0.0.0.0, “--any--” displays.
Port
Local port.
In
Input queue size.
Out
Output queue size.
Stat
Various statistics for a socket.
TTY
The tty number for the creator of this socket.
OutputIF
Output IF string, if one exists.
v6
IPv6 sockets.
show ip tcp header-compression
To display TCP/IP header compression statistics, use the show ip tcp header-compression command in user EXEC or privileged EXEC mode.
Command History
Release
Modification
10.0
This command was introduced.
12.4
This command was integrated into Cisco Release 12.4 and its command output was modified to include additional compression statistics.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.4(15)T12
This command was modifed. Support was added for the special Van Jacobson (VJ) format of TCP header compression.
Examples
The following is sample output from the show ip tcp header-compression command:
Router# show ip tcp header-compression TCP/IP header compression statistics: Interface Serial2/0 (compression on, IETF) Rcvd: 53797 total, 53796 compressed, 0 errors, 0 status msgs 0 dropped, 0 buffer copies, 0 buffer failures Sent: 53797 total, 53796 compressed, 0 status msgs, 0 not predicted 1721848 bytes saved, 430032 bytes sent 5.00 efficiency improvement factor Connect: 16 rx slots, 16 tx slots, 1 misses, 0 collisions, 0 negative cache hits, 15 free contexts 99% hit ratio, five minute miss rate 0 misses/sec, 0 maxThe table below describes the significant fields shown in the display.
The following example for Cisco IOS Release 12.4(15)T12 shows that the TCP special VJ format is enabled:
Router# show ip tcp header-compression serial 5/0 detail TCP/IP header compression statistics: DLCI 100 Link/Destination info: ip 10.72.72.2 Configured: Max Header 60 Bytes, Max Time 50 Secs, Max Period 32786 Packets, Feedback On, Spl-VJ On Negotiated: Max Header 60 Bytes, Max Time 50 Secs, Max Period 32786 Packets, Feedback On, Spl-VJ On TX contexts:Related Commands
Command
Description
ip header-compression special-vj
Enables the special VJ format of TCP header compression.
ip tcp compression-connections
Specifies the total number of TCP header compression connections that can exist on an interface
special-vj
Enables the special VJ format of TCP header compression so that context IDs are included in compressed packets.
show ip traffic
To display the global or system-wide IP traffic statistics for one or more interfaces, use the show ip traffic command in user EXEC or privileged EXEC mode.
Command Default
Using the show ip traffic command with no keywords or arguments displays the global or system-wide IP traffic statistics for all interfaces.
Command History
Release
Modification
10.0
This command was introduced.
12.2
The output was enhanced to display the number of keepalive, open, update, route-refresh request, and notification messages received and sent by a Border Gateway Protocol (BGP) routing process.
12.2(25)S
The command output was modified.
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.
12.4(20)T
This command was integrated into Cisco IOS Release 12.4(20)T.
12.2(33)SXH5
This command was modified. The output was changed to display the ARP (proxy) reply counter as the number of ARP replies for real proxies only.
Cisco IOS XE Release 3.1S
This command was integrated into Cisco IOS XE Release 3.1S. This command was modified to include the optional interface keyword and associated type and number arguments. These modifications were made to provide support for the IPv4 MIBs as described in RFC 4293: Management Information Base for the Internet Protocol (IP).
15.1(4)M
This command was modified. The optional interface keyword and associated type and tynumber arguments were added. These modifications were made to provide support for the IPv4 MIBs as described in RFC 4293, Management Information Base for the Internet Protocol (IP).
Usage Guidelines
Using the show ip traffic command with the optional interface keyword displays the ipIfStatsTable counters for the specified interface if IPv4 addressing is enabled.
Examples
The following is sample output from the show ip traffic command:
Router# show ip traffic IP statistics: Rcvd: 27 total, 27 local destination 0 format errors, 0 checksum errors, 0 bad hop count 0 unknown protocol, 0 not a gateway 0 security failures, 0 bad options, 0 with options Opts: 0 end, 0 nop, 0 basic security, 0 loose source route 0 timestamp, 0 extended security, 0 record route 0 stream ID, 0 strict source route, 0 alert, 0 cipso, 0 ump 0 other Frags: 0 reassembled, 0 timeouts, 0 couldn't reassemble 0 fragmented, 0 couldn't fragment Bcast: 27 received, 0 sent Mcast: 0 received, 0 sent Sent: 0 generated, 0 forwarded Drop: 0 encapsulation failed, 0 unresolved, 0 no adjacency 0 no route, 0 unicast RPF, 0 forced drop Drop: 0 packets with source IP address zero ICMP statistics: Rcvd: 0 format errors, 0 checksum errors, 0 redirects, 0 unreachable 0 echo, 0 echo reply, 0 mask requests, 0 mask replies, 0 quench 0 parameter, 0 timestamp, 0 info request, 0 other 0 irdp solicitations, 0 irdp advertisements 0 time exceeded, 0 timestamp replies, 0 info replies Sent: 0 redirects, 0 unreachable, 0 echo, 0 echo reply 0 mask requests, 0 mask replies, 0 quench, 0 timestamp 0 info reply, 0 time exceeded, 0 parameter problem 0 irdp solicitations, 0 irdp advertisements BGP statistics: Rcvd: 0 total, 0 opens, 0 notifications, 0 updates 0 keepalives, 0 route-refresh, 0 unrecognized Sent: 0 total, 0 opens, 0 notifications, 0 updates 0 keepalives, 0 route-refresh EIGRP-IPv4 statistics: Rcvd: 0 total Sent: 0 total TCP statistics: Rcvd: 0 total, 0 checksum errors, 0 no port Sent: 0 total PIMv2 statistics: Sent/Received Total: 0/0, 0 checksum errors, 0 format errors Registers: 0/0 (0 non-rp, 0 non-sm-group), Register Stops: 0/0, Hellos: 0/0 Join/Prunes: 0/0, Asserts: 0/0, grafts: 0/0 Bootstraps: 0/0, Candidate_RP_Advertisements: 0/0 State-Refresh: 0/0 IGMP statistics: Sent/Received Total: 0/0, Format errors: 0/0, Checksum errors: 0/0 Host Queries: 0/0, Host Reports: 0/0, Host Leaves: 0/0 DVMRP: 0/0, PIM: 0/0 UDP statistics: Rcvd: 185515 total, 0 checksum errors, 185515 no port Sent: 0 total, 0 forwarded broadcasts OSPF statistics: Rcvd: 0 total, 0 checksum errors 0 hello, 0 database desc, 0 link state req 0 link state updates, 0 link state acks Sent: 0 total 0 hello, 0 database desc, 0 link state req 0 link state updates, 0 link state acks Probe statistics: Rcvd: 0 address requests, 0 address replies 0 proxy name requests, 0 where-is requests, 0 other Sent: 0 address requests, 0 address replies (0 proxy) 0 proxy name replies, 0 where-is replies ARP statistics: Rcvd: 1477 requests, 8841 replies, 396 reverse, 0 other Sent: 1 requests, 20 replies (0 proxy), 0 reverse Drop due to input queue full: 0The following is sample output from the show ip traffic command for Ethernet interface 0/0:Router# show ip traffic interface ethernet 0/0 Ethernet0/0 IP-IF statistics : Rcvd: 99 total, 9900 total_bytes 0 format errors, 0 hop count exceeded 0 bad header, 0 no route 0 bad destination, 0 not a router 0 no protocol, 0 truncated 0 forwarded 0 fragments, 0 total reassembled 0 reassembly timeouts, 0 reassembly failures 0 discards, 99 delivers Sent: 99 total, 9900 total_bytes 0 discards 99 generated, 0 forwarded 0 fragmented into, 0 fragments, 0 failed Mcast: 0 received, 0 received bytes 0 sent, 0 sent bytes Bcast: 0 received, 0 sentExamples
The following is sample output from the show ip traffic command when used on a Cisco 10000 series router:
Router# show ip traffic IP statistics: Rcvd: 27 total, 27 local destination 0 format errors, 0 checksum errors, 0 bad hop count 0 unknown protocol, 0 not a gateway 0 security failures, 0 bad options, 0 with options Opts: 0 end, 0 nop, 0 basic security, 0 loose source route 0 timestamp, 0 extended security, 0 record route 0 stream ID, 0 strict source route, 0 alert, 0 cipso, 0 ump 0 other Frags: 0 reassembled, 0 timeouts, 0 couldn't reassemble 0 fragmented, 0 couldn't fragment Bcast: 27 received, 0 sent Mcast: 0 received, 0 sent Sent: 0 generated, 0 forwarded Drop: 0 encapsulation failed, 0 unresolved, 0 no adjacency 0 no route, 0 unicast RPF, 0 forced drop 0 options denied, 0 source IP address zeroThe table below describes the significant fields shown in the display.
Table 3 show ip traffic Field Descriptions Field
Description
format errors
Indicates a gross error in the packet format, such as an impossible Internet header length.
bad hop count
Occurs when a packet is discarded because its time-to-live (TTL) field was decremented to zero.
encapsulation failed
Usually indicates that the router had no ARP request entry and therefore did not send a datagram.
no route
Counted when the Cisco IOS software discards a datagram that it did not know how to route.
show ip wccp
To display the IPv4 Web Cache Communication Protocol (WCCP) global configuration and statistics, use the show ip wccp command in user EXEC or privileged EXEC mode.
show ip wccp [ all ] [capabilities] [summary] [ interfaces [ cef | counts | detail ] ] [ vrf vrf-name ] [ { web-cache | service-number } [assignment] [clients] [counters] [detail] [service] [view] ]Syntax Description
all
(Optional) Displays statistics for all known services.
capabilities
(Optional) Displays WCCP platform capabilities information.
summary
(Optional) Displays a summary of WCCP services.
interfaces
(Optional) Displays WCCP redirect interfaces.
cef
(Optional) Displays Cisco Express Forwarding interface statistics, including the number of input, output, dynamic, static, and multicast services.
counts
(Optional) Displays WCCP interface count statistics, including the number of Cisco Express Forwarding and process-switched output and input packets redirected.
detail
(Optional) Displays WCCP interface configuration statistics, including the number of input, output, dynamic, static, and multicast services.
vrf vrf-name
(Optional) Specifies a virtual routing and forwarding (VRF) instance associated with a service group to display.
web-cache
(Optional) Displays statistics for the web cache service.
service-number
(Optional) Identification number of the web cache service group being controlled by the cache. The number can be from 0 to 254. For web caches using Cisco cache engines, the reverse proxy service is indicated by a value of 99.
assignment
(Optional) Displays service group assignment information.
clients
(Optional) Displays detailed information about the clients of a service, including all per-client information. No per-service information is displayed.
counters
(Optional) Displays traffic counters.
detail
(Optional) Displays detailed information about the clients of a service, including all per-client information. No per-service information is displayed. Assignment information is also displayed.
service
(Optional) Displays detailed information about a service, including the service definition and all other per-service information.
view
(Optional) Displays other members of a particular service group, or all service groups, that have or have not been detected.
Command History
Release
Modification
11.1CA
This command was introduced for Cisco 7200 and 7500 platforms.
11.2P
Support for this command was added to a variety of Cisco platforms.
12.0(3)T
The detail and view keywords were added.
12.3(7)T
The output was enhanced to display the bypass counters (process and Cisco Express Forwarding) when WCCP is enabled.
12.2(14)SX
Support for this command was added for the Supervisor Engine 720.
12.2(17d)SXB
Support for this command was added for the Supervisor Engine 2.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.3(14)T
The output was enhanced to display the maximum number of service groups.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(11)T
This command was enhanced to display information about the WCCP service mode.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
Cisco IOS XE Release 2.2
This command was integrated into Cisco IOS XE Release 2.2.
15.0(1)M
This command was modified. The summary keyword and the vrf vrf-name keyword and argument pair were added.
12.2(33)SRE
This command was modified. The summary keyword and the vrf vrf-name keyword and argument pair were added.
Cisco IOS XE Release 3.1S
This command was modified. The following keywords and arguments were added: all, assignment, capabilities, clients, counters, full, id ip-address, service, summary, and vrf vrf-name. The output was modified to display information about the WCCP client timeout interval and the redirect assignment timeout.
12.2(50)SY
This command was modified. The summary keyword and the vrf vrf-name keyword and argument pair were added.
15.2(3)T
This command was integrated into Cisco IOS Release 15.2(3)T.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
Cisco IOS XE 3.3SE
This command was implemented in Cisco IOS XE Release 3.3SE.
Usage Guidelines
Use the clear ip wccp command to reset all WCCP counters.
Use the show ip wccp service-number detail command to display information about the WCCP client timeout interval and the redirect assignment timeout interval if those intervals are not set to their default value of 10 seconds.
Use the show ip wccp summary command to display the configured WCCP services and a summary of their current state.
On Cisco ASR 1000 Series Aggregation Services Routers, nonzero values can only be seen for platform-specific counters because Cisco ASR 1000 Series Routers implement all redirection in hardware. Configuring the counters keyword also displays counters received in hardware.
Examples
This section contains examples and field descriptions for the following forms of this command:
- show ip wccp service-number (service mode displayed)
- show ip wccp service-number view
- show ip wccp service-number detail
- show ip wccp service-number clients
- show ip wccp interfaces
- show ip wccp web-cache
- show ip wccp web-cache counters
- show ip wccp web-cache detail
- show ip wccp web-cache detail (bypass counters displayed)
- show ip wccp web-cache clients
- show ip wccp web-cache service
- show ip wccp summary
Examples
The following is sample output from the show ip wccp service-number command:
Router# show ip wccp 90 Global WCCP information: Router information: Router Identifier: 209.165.200.225 Service Identifier: 90 Protocol Version: 2.00 Number of Service Group Clients: 2 Number of Service Group Routers: 1 Total Packets Redirected: 0 Process: 0 CEF: 0 Service mode: Open Service Access-list: -none- Total Packets Dropped Closed: 0 Redirect access-list: -none- Total Packets Denied Redirect: 0 Total Packets Unassigned: 0 Group access-list: -none- Total Messages Denied to Group: 0 Total Authentication failures: 0 Total GRE Bypassed Packets Received: 0 Process: 0 CEF: 0The table below describes the significant fields shown in the display.
Table 4 show ip wccp service-number Field Descriptions Field
Description
Router information
A list of routers detected by the current router.
Protocol Version
The version of WCCP being used by the router in the service group.
Service Identifier
Indicates which service is detailed.
Number of Service Group Clients
The number of clients that are visible to the router and other clients in the service group.
Number of Service Group Routers
The number of routers in the service group.
Total Packets Redirected
Total number of packets redirected by the router.
Service mode
Identifies the WCCP service mode. Options are Open or Closed.
Service Access-list
A named extended IP access list that defines the packets that will match the service.
Total Packets Dropped Closed
Total number of packets that were dropped when WCCP is configured for closed services and an intermediary device is not available to process the service.
Redirect access-list
The name or number of the access list that determines which packets will be redirected.
Total Packets Denied Redirect
Total number of packets that were not redirected because they did not match the access list.
Total Packets Unassigned
Number of packets that were not redirected because they were not assigned to any cache engine. Packets may not be assigned during initial discovery of cache engines or when a cache is dropped from a cluster.
Group access-list
Indicates which cache engine is allowed to connect to the router.
Total Messages Denied to Group
Indicates the number of packets denied by the group-list access list.
Total Authentication failures
The number of instances where a password did not match.
Total GRE Bypassed Packets Received
The number of generic routing encapsulation (GRE) packets that have been bypassed. Process and Cisco Express Forwarding are switching paths within Cisco IOS software.
Examples
The following is sample output from the show ip wccp service-number view command for service group 1:
Router# show ip wccp 90 view WCCP Routers Informed of: 209.165.200.225 209.165.200.226 WCCP Clients Visible 209.165.200.227 209.165.200.228 WCCP Clients Not Visible: -none-
Note
The number of maximum service groups that can be configured is 256.
If any web cache is displayed under the WCCP Cache Engines Not Visible field, the router needs to be reconfigured to map the web cache that is not visible to it.
The table below describes the significant fields shown in the display.
Table 5 show ip wccp service-number view Field Descriptions Field
Description
WCCP Router Informed of
A list of routers detected by the current router.
WCCP Clients Visible
A list of clients that are visible to the router and other clients in the service group.
WCCP Clients Not Visible
A list of clients in the service group that are not visible to the router and other clients in the service group.
Examples
The following example displays WCCP client information and WCCP router statistics that include the type of services:
Router# show ip wccp 91 detail WCCP Client information: WCCP Client ID: 209.165.200.226 Protocol Version: 2.0 State: Usable Redirection: L2 Packet Return: L2 Assignment: MASK Connect Time: 6d20h Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Mask Allotment: 32 of 64 (50.00%) Assigned masks/values: 1/32 Mask SrcAddr DstAddr SrcPort DstPort ---- ------- ------- ------- ------- 0000: 0x00000000 0x00001741 0x0000 0x0000 Value SrcAddr DstAddr SrcPort DstPort ----- ------- ------- ------- ------- 0000: 0x00000000 0x00000001 0x0000 0x0000 0001: 0x00000000 0x00000041 0x0000 0x0000 0002: 0x00000000 0x00000101 0x0000 0x0000 0003: 0x00000000 0x00000141 0x0000 0x0000 0004: 0x00000000 0x00000201 0x0000 0x0000 0005: 0x00000000 0x00000241 0x0000 0x0000 0006: 0x00000000 0x00000301 0x0000 0x0000 0007: 0x00000000 0x00000341 0x0000 0x0000 0008: 0x00000000 0x00000401 0x0000 0x0000 0009: 0x00000000 0x00000441 0x0000 0x0000 0010: 0x00000000 0x00000501 0x0000 0x0000 0011: 0x00000000 0x00000541 0x0000 0x0000 0012: 0x00000000 0x00000601 0x0000 0x0000 0013: 0x00000000 0x00000641 0x0000 0x0000 0014: 0x00000000 0x00000701 0x0000 0x0000 0015: 0x00000000 0x00000741 0x0000 0x0000 0016: 0x00000000 0x00001001 0x0000 0x0000 0017: 0x00000000 0x00001041 0x0000 0x0000 0018: 0x00000000 0x00001101 0x0000 0x0000 0019: 0x00000000 0x00001141 0x0000 0x0000 0020: 0x00000000 0x00001201 0x0000 0x0000 0021: 0x00000000 0x00001241 0x0000 0x0000 0022: 0x00000000 0x00001301 0x0000 0x0000 0023: 0x00000000 0x00001341 0x0000 0x0000 0024: 0x00000000 0x00001401 0x0000 0x0000 0025: 0x00000000 0x00001441 0x0000 0x0000 0026: 0x00000000 0x00001501 0x0000 0x0000 0027: 0x00000000 0x00001541 0x0000 0x0000 0028: 0x00000000 0x00001601 0x0000 0x0000 0029: 0x00000000 0x00001641 0x0000 0x0000 0030: 0x00000000 0x00001701 0x0000 0x0000 0031: 0x00000000 0x00001741 0x0000 0x0000 WCCP Client ID: 192.0.2.11 Protocol Version: 2.01 State: Usable Redirection: L2 Packet Return: L2 Assignment: MASK Connect Time: 6d20h Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Mask Allotment: 32 of 64 (50.00%) Assigned masks/values: 1/32 Mask SrcAddr DstAddr SrcPort DstPort ---- ------- ------- ------- ------- 0000: 0x00000000 0x00001741 0x0000 0x0000 Value SrcAddr DstAddr SrcPort DstPort ----- ------- ------- ------- ------- 0000: 0x00000000 0x00000000 0x0000 0x0000 0001: 0x00000000 0x00000040 0x0000 0x0000 0002: 0x00000000 0x00000100 0x0000 0x0000 0003: 0x00000000 0x00000140 0x0000 0x0000 0004: 0x00000000 0x00000200 0x0000 0x0000 0005: 0x00000000 0x00000240 0x0000 0x0000 0006: 0x00000000 0x00000300 0x0000 0x0000 0007: 0x00000000 0x00000340 0x0000 0x0000 0008: 0x00000000 0x00000400 0x0000 0x0000 0009: 0x00000000 0x00000440 0x0000 0x0000 0010: 0x00000000 0x00000500 0x0000 0x0000 0011: 0x00000000 0x00000540 0x0000 0x0000 0012: 0x00000000 0x00000600 0x0000 0x0000 0013: 0x00000000 0x00000640 0x0000 0x0000 0014: 0x00000000 0x00000700 0x0000 0x0000 0015: 0x00000000 0x00000740 0x0000 0x0000 0016: 0x00000000 0x00001000 0x0000 0x0000 0017: 0x00000000 0x00001040 0x0000 0x0000 0018: 0x00000000 0x00001100 0x0000 0x0000 0019: 0x00000000 0x00001140 0x0000 0x0000 0020: 0x00000000 0x00001200 0x0000 0x0000 0021: 0x00000000 0x00001240 0x0000 0x0000 0022: 0x00000000 0x00001300 0x0000 0x0000 0023: 0x00000000 0x00001340 0x0000 0x0000 0024: 0x00000000 0x00001400 0x0000 0x0000 0025: 0x00000000 0x00001440 0x0000 0x0000 0026: 0x00000000 0x00001500 0x0000 0x0000 0027: 0x00000000 0x00001540 0x0000 0x0000 0028: 0x00000000 0x00001600 0x0000 0x0000 0029: 0x00000000 0x00001640 0x0000 0x0000 0030: 0x00000000 0x00001700 0x0000 0x0000 0031: 0x00000000 0x00001740 0x0000 0x0000The table below describes the significant fields shown in the display.
Table 6 show ip wccp service-number detail Field Descriptions Field
Description
Protocol Version
Indicates whether WCCPv1 or WCCPv2 is enabled.
State
Indicates whether the WCCP client is operating properly and can be contacted by a router and other clients in the service group.
When a WCCP client has an incompatible message interval setting, the state of the client is shown as "NOT Usable," followed by a status message describing the reason why the client is not usable.
Redirection
Indicates the redirection method used. WCCP uses GRE or L2 to redirect IP traffic.
Assignment
Indicates the load-balancing method used. WCCP uses HASH or MASK assignment.
Connect Time
The amount of time the client has been connected to the router.
Redirected Packets
The number of packets that have been redirected to the content engine.
Examples
The following example displays WCCP client information and WCCP router statistics that include the type of services:
Router# show ip wccp 91 clients WCCP Client information: WCCP Client ID: 10.1.1.14 Protocol Version: 2.0 State: Usable Redirection: L2 Packet Return: L2 Assignment: MASK Connect Time: 6d20h Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Mask Allotment: 32 of 64 (50.00%) WCCP Client ID: 192.0.2.11 Protocol Version: 2.01 State: Usable Redirection: L2 Packet Return: L2 Assignment: MASK Connect Time: 6d20h Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Mask Allotment: 32 of 64 (50.00%)The table below describes the significant fields shown in the display.
Table 7 show ip wccp service-number clients Field Descriptions Field
Description
Protocol Version
Indicates whether WCCPv1 or WCCPv2 is enabled.
State
Indicates whether the WCCP client is operating properly and can be contacted by a router and other clients in the service group.
When a WCCP client has an incompatible message interval setting, the state of the client is shown as "NOT Usable," followed by a status message describing the reason why the client is not usable.
Redirection
Indicates the redirection method used. WCCP uses GRE or L2 to redirect IP traffic.
Assignment
Indicates the load-balancing method used. WCCP uses HASH or MASK assignment.
Connect Time
The amount of time (in seconds) the client has been connected to the router.
Redirected Packets
The number of packets that have been redirected to the content engine.
Examples
The following is sample output from the show ip wccp interfaces command:
Router# show ip wccp interfaces IPv4 WCCP interface configuration: FastEthernet2/1 Output services: 0 Input services: 1 Mcast services: 0 Exclude In: FALSEThe table below describes the significant fields shown in the display.
Table 8 show ip wccp interfaces Field Descriptions Field
Description
Output services
Indicates the number of output services configured on the interface.
Input services
Indicates the number of input services configured on the interface.
Mcast services
Indicates the number of multicast services configured on the interface.
Exclude In
Displays whether traffic on the interface is excluded from redirection.
Examples
The following is sample output from the show ip wccp web-cache command:
Router# show ip wccp web-cache Global WCCP information: Router information: Router Identifier: 209.165.200.225 Service Identifier: web-cache Protocol Version: 2.00 Number of Service Group Clients: 2 Number of Service Group Routers: 1 Total Packets Redirected: 0 Process: 0 CEF: 0 Service mode: Open Service Access-list: -none- Total Packets Dropped Closed: 0 Redirect access-list: -none- Total Packets Denied Redirect: 0 Total Packets Unassigned: 0 Group access-list: -none- Total Messages Denied to Group: 0 Total Authentication failures: 0 Total GRE Bypassed Packets Received: 0 Process: 0 CEF: 0 GRE tunnel interface: Tunnel0The table below describes the significant fields shown in the display.
Table 9 show ip wccp web-cache Field Descriptions Field
Description
Service Identifier
Indicates which service is detailed.
Protocol Version
Indicates whether WCCPv1 or WCCPv2 is enabled.
Number of Service Group Clients
Number of clients using the router as their home router.
Number of Service Group Routers
The number of routers in the service group.
Total Packets Redirected
Total number of packets redirected by the router.
Service mode
Indicates whether WCCP open or closed mode is configured.
Service Access-list
The name or number of the service access list that determines which packets will be redirected.
Redirect access-list
The name or number of the access list that determines which packets will be redirected.
Total Packets Denied Redirect
Total number of packets that were not redirected because they did not match the access list.
Total Packets Unassigned
Number of packets that were not redirected because they were not assigned to any cache engine. Packets may not be assigned during initial discovery of cache engines or when a cache is dropped from a cluster.
Group access-list
Indicates which cache engine is allowed to connect to the router.
Total Messages Denied to Group
Indicates the number of packets denied by the group-list access list.
Total Authentication failures
The number of instances where a password did not match.
Examples
The following example displays web cache engine information and WCCP traffic counters:
Router# show ip wccp web-cache counters WCCP Service Group Counters: Redirected Packets: Process: 0 CEF: 0 Non-Redirected Packets: Action - Forward: Reason - no assignment: Process: 0 CEF: 0 Action - Ignore (forward): Reason - redir ACL check: Process: 0 CEF: 0 Action - Discard: Reason - closed services: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 GRE Bypassed Packet Errors: Total Errors: Process: 0 CEF: 0 WCCP Client Counters: WCCP Client ID: 192.0.2.12 Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 WCCP Client ID: 192.0.2.11 Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0The table below describes the significant fields shown in the display.
Examples
The following example displays web cache engine information and WCCP router statistics for the web cache service:
Router# show ip wccp web-cache detail WCCP Client information: WCCP Client ID: 209.165.200.225 Protocol Version: 2.0 State: Usable Redirection: GRE Packet Return: GRE Assignment: HASH Connect Time: 1w5d Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Hash Allotment: 128 of 256 (50.00%) Initial Hash Info: 00000000000000000000000000000000 00000000000000000000000000000000 Assigned Hash Info: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA WCCP Client ID: 192.0.2.11 Protocol Version: 2.01 State: Usable Redirection: GRE Packet Return: GRE Assignment: HASH Connect Time: 1w5d Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Hash Allotment: 128 of 256 (50.00%) Initial Hash Info: 00000000000000000000000000000000 00000000000000000000000000000000 Assigned Hash Info: 55555555555555555555555555555555 55555555555555555555555555555555The table below describes the significant fields shown in the display.
Table 11 show ip wccp web-cache detail Field Descriptions Field
Description
WCCP Client Information
The header for the area that contains fields for information on clients.
Protocol Version
The version of WCCP being used by the cache engine in the service group.
State
Indicates whether the cache engine is operating properly and can be contacted by a router and other cache engines in the service group.
Connect Time
The amount of time the cache engine has been connected to the router.
Redirected Packets
The number of packets that have been redirected to the cache engine.
Examples
The following example displays web cache engine information and WCCP router statistics that include the bypass counters:
Router# show ip wccp web-cache detail WCCP Client information: WCCP Client ID: 209.165.200.225 Protocol Version: 2.01 State: Usable Redirection: GRE Packet Return: GRE Assignment: HASH Connect Time: 1w5d Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Hash Allotment: 128 of 256 (50.00%) Initial Hash Info: 00000000000000000000000000000000 00000000000000000000000000000000 Assigned Hash Info: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA WCCP Client ID: 209.165.200.226 Protocol Version: 2.01 State: Usable Redirection: GRE Packet Return: GRE Assignment: HASH Connect Time: 1w5d Redirected Packets: Process: 0 CEF: 0 GRE Bypassed Packets: Process: 0 CEF: 0 Hash Allotment: 128 of 256 (50.00%) Initial Hash Info: 00000000000000000000000000000000 00000000000000000000000000000000 Assigned Hash Info: 55555555555555555555555555555555 55555555555555555555555555555555The table below describes the significant fields shown in the display.
Table 12 show ip wccp web-cache detail Field Descriptions Field
Description
WCCP Client Information
The header for the area that contains fields for information on clients.
Protocol Version
The version of WCCP that is being used by the router in the service group.
State
Indicates whether the cache engine is operating properly and can be contacted by a router and other cache engines in the service group.
Connect Time
The amount of time the cache engine has been connected to the router.
Hash Allotment
The percent of buckets assigned to the current cache engine. Both a value and a percent figure are displayed.
Initial Hash Info
The initial state of the hash bucket assignment.
Assigned Hash Info
The current state of the hash bucket assignment.
Redirected Packets
The number of packets that have been redirected to the cache engine.
GRE Bypassed Packets
The number of packets that have been bypassed. Process and Cisco Express Forwarding are switching paths within Cisco IOS software.
Examples
The following example displays information about a service, including the service definition and all other per-service information:
Router# show ip wccp web-cache service WCCP service information definition: Type: Standard Id: 0 Priority: 240 Protocol: 6 Flags: 0x00000512 Hash: DstIP Alt Hash: SrcIP SrcPort Ports used: Destination Ports: 80Examples
The following example displays information about the configured WCCP services and a summary of their current state:
Router# show ip wccp summary WCCP version 2 enabled, 2 services Service Clients Routers Assign Redirect Bypass ------- ------- ------- ------ -------- ------ Default routing table (Router Id: 209.165.200.225): web-cache 2 1 HASH GRE GRE 90 0 0 HASH/MASK GRE/L2 GRE/L2The table below describes the significant fields shown in the display.
Table 13 show ip wccp summary Field Descriptions Field
Description
Service
Indicates which service is detailed.
Clients
Indicates the number of cache engines participating in the WCCP service.
Routers
Indicates the number of routers participating in the WCCP service.
Assign
Indicates the load-balancing method used. WCCP uses HASH or MASK assignment.
Redirect
Indicates the redirection method used. WCCP uses GRE or L2 to redirect IP traffic.
Bypass
Indicates the bypass method used. WCCP uses GRE or L2 to return packets to the router.
Related Commands
Command
Description
clear ip wccp
Clears the counter for packets redirected using WCCP.
ip wccp
Enables support of the WCCP service for participation in a service group.
ip wccp redirect
Enables packet redirection on an outbound or inbound interface using WCCP.
show ip interface
Lists a summary of the IP information and status of an interface.
show ip wccp global counters
Displays global WCCP information for packets that are processed in software.
show ip wccp service-number detail
Displays information about the WCCP client timeout interval and the redirect assignment timeout interval if those intervals are not set to their default value of 10 seconds.
show ip wccp summary
Displays the configured WCCP services and a summary of their current state.
show platform software wccp
Displays global statistics related to WCCP on Cisco ASR 1000 Series Aggregation Services Routers.
show ip wccp global counters
To display IPv4 global Web Cache Communication Protocol (WCCP) information for packets that are processed in software, use the show ip wccp global counters command in user EXEC or privileged EXEC mode.
Usage Guidelines
The show ip wccp global counters command displays counters for packets that are processed in software. These counters are always zero on the Cisco ASR 1000 Series Aggregation Services Routers.
Examples
The following example displays global WCCP information for packets that are processed in the software:
Router# show ip wccp global counters WCCP Global Counters: Packets Seen by WCCP Process: 8 CEF (In): 14 CEF (Out): 0Related Commands
Command
Description
clear ip wccp
Clears the counters for packets redirected using WCCP.
ip wccp
Enables support of the WCCP service for participation in a service group.
ip wccp redirect
Enables packet redirection on an outbound or inbound interface using WCCP.
ip wccp web-cache accelerated
Enables the hardware acceleration for WCCP version 1.
show ip interface
Lists a summary of the IP information and the status of an interface.
show ip wccp
Displays the WCCP global configuration and statistics.
show platform hardware qfp active feature wccp
To display the Web Cache Communication Protocol (WCCP) service group information in the active Cisco Quantum Flow Processor (QFP), use the show platform hardware qfp active feature wccp command in privileged EXEC mode.
Examples
The following is a sample output of the show platform hardware qfp active feature wccp command:
Router# show platform hardware qfp active feature wccp service id 1 Service ID: 0 Service Priority: 240 CG ID: 0 Mode: Open Num bind objs: 64 Number of Caches in this service: 1 ce index: 0 cache_id : 15 Cache ip addr : 0x5a140102 Cache cfg ppe addr : 0x8b480000 Cache oce ppe addr : 0x89b01480 Cache state ppe addr : 0x8b4d0400 Number of interfaces using this service: 1 Interface: GigabitEthernet0/3/1 cpp-if-h: 18 Dir: 0 pal-if-h: 20The table below describes the significant fields shown in the display:
Table 15 show platform hardware qfp active feature wccp Field Descriptions Field
Description
Service ID
Service group number (0 for webcache and 1 to 254 for dynamic services).
Service Priority
Priority of the service group.
CG ID
Class Group ID.
Mode
Specifies whether the service group has been defined as an open service group (default value) or closed service group.
Num bind objs
Number of access control entries (ACEs) in the merged access control list (ACL) for this service group. On the Quantum Flow Processor (QFP), each ACE is programmed as a bind object under a class group specified by the CG ID.
Number of Caches in this service
The number of cache engines available for this service group.
Number of interfaces using this service
The number of interfaces on which this service group has been configured (both inbound as well as outbound redirection).
Examples
The following is a sample output of the show platform hardware qfp active feature wccp ipv6 command:
Router# show platform hardware qfp active feature wccp service id 61 ipv6 Service ID: 61 Service Type: 1 Service Priority: 34 Assign Method: 1 Hash key: 0x51 Hash buckets ppe address: 0x8bceb600 Mode: Open State: Active Number of Caches in this service: 1 ce index: 0 cache_id : 11 Cache ip addr : 0x20010001 Cache cfg ppe addr : 0x8bcab200 Cache oce ppe addr : 0x891a7670 Cache state ppe addr : 0x8bcfd288 Number of interfaces using this service: 1 Interface: GigabitEthernet0/0/0.1 cpp-if-h: 12 Dir: 0 pal-if-h: 15 uidb sb ppe addr: 0x8bd308e0The table below describes the significant fields shown in the display:
Table 16 show platform hardware qfp active feature wccp ipv6 Field Descriptions Field
Description
Service ID
Service group number (0 for webcache and 1 to 254 for dynamic services).
Service Type
Specifies the WCCP service type, whether standard or dynamic.
Service Priority
Priority of the service group.
Assign Method
Indicates the load-balancing method used (1 for hash and 0 for mask).
Hash key
Identifies the hash value.
Hash buckets ppe address
Specifies the PPE address of the hash bucket.
Mode
Specifies whether the service group has been defined as an open service group (default value) or closed service group.
State
Specifies the current WCCP state.
Number of Caches in this service
The number of cache engines available for this service group.
Number of interfaces using this service
The number of interfaces on which this service group has been configured (both inbound as well as outbound redirection).
show platform software wccp
To display platform specific configuration and statistics related WCCP information on Cisco ASR 1000 Series Routers, use the show platform software wccp command in privileged EXEC mode.
show platform software wccp [ service-number ipv6 counters | [ slot { active | standby } [ service-number { access-list | ipv6 } | cache-info | interface | statistics | web-cache { access-list | ipv6 } ] | [ vrf vrf-identifier { service-number { access-list | ipv6 } | web-cache { access-list | ipv6 } } ] ] | interface counters | statistics | [ vrf vrf-identifier { service-number ipv6 counters | web-cache ipv6 counters } ] | web-cache ipv6 counters ]
Syntax Description
service-number
(Optional) Displays information for a dynamically defined service. The service number can be from 0 to 254.
ipv6
(Optional) Specifies the IPv6 service.
counters
(Optional) Displays counter information.
slot
(Optional) Embedded Service Processor or Route Processor slot.
Valid options are:
active
(Optional) Specifies an active instance.
standby
(Optional) Specifies a standby instance.
service-number
(Optional) Displays information for a dynamically defined service.
access-list
(Optional) Displays WCCP access list information.
cache-info
(Optional) Displays cache-engine information.
interface
(Optional) Displays information about interfaces bound to WCCP services.
statistics
(Optional) Displays internal messaging statistics for WCCP. Displayed counters are self-descriptive.
web-cache
(Optional) Displays information about the web cache service.
web-cache
(Optional) Displays web cache information.
vrf vrf-identifier
(Optional) Specifies a virtual routing and forwarding instance (VRF) associated with a service group to display.
Usage Guidelines
Use the show platform software wccp to display global statistics and configuration information related to WCCP on the Cisco ASR 1000 Series Routers. The show ip wccp command displays information about software-based (process, fast, and Cisco Express Forwarding [CEF]) forwarding of WCCP packets. The Cisco ASR 1000 Services Routers implement WCCP in hardware, rather than in the CEF or process-switching paths. The show ip wccp displays WCCP counters, but only platform fields have nonzero values because redirection happens in hardware.
Examples
The following is a sample output of the show platform software wccp counters command:
Router# show platform software wccp 61 counters Service Group (1, 61) counters Unassigned count = 0 Dropped due to closed service count = 0 Bypass count = 0 Bypass failed count = 0 Denied count = 0 Redirect count = 313635910244 CE = 10.1.1.2, obj_id = 58, Redirect Packets = 42768533218 CE = 10.2.1.2, obj_id = 165, Redirect Packets = 45619768766 . . .The following is a sample output of the show platform software wccp ipv6 counters command:
Router# show platform software wccp 61 ipv6 counters Service Group (1, 61, 0) counters Unassigned count = 0 Dropped due to closed service count = 0 Bypass count = 0 Bypass failed count = 0 Denied count = 0 Redirect count = 4 CE = 2001:1:100::105, obj_id = 213, Redirect Packets = 4The table below describes the significant fields shown in the display.
Table 17 show platform software wccp counters Field Descriptions Field
Description
Service Group (1, 61,0) counters
Dynamic service group 61 counters.
Unassigned count
Number of packets that were not redirected because they were not assigned to any cache engine. Packets may not be assigned during initial discovery of cache engines or when a cache is dropped from a cluster.
Dropped due to closed service count = 0
This output field is not supported in Cisco IOS XE Release 2.2 and always returns a value of 0.
Bypass count
The number of packets that have been bypassed.
Bypass failed count
Number of bypass packets that WCCP could not find the original input interface.
Denied count
Total number of packets that were not redirected because they did not match the access list.
Redirect count
Total number of packets redirected by the router.
CE = 10.1.1.2, obj_id = 58, Redirect Packets = 42768533218
The number of packets redirected to each cache-engine.
The following is a sample output of the show platform software wccp slot interface command:
Router# show platform software wccp f0 interface Interface FastEthernet0/1/0 if_handle: 11, direction: In Standard web-cache serviceThe table below describes the significant fields shown in the display.
Table 18 show platform software wccp slot interface Field Descriptions Field
Description
Interface FastEthernet0/1/0
Name of the interface on which the WCCP service is applied.
if_handle
The internal interface index associated with the above interface.
direction: In
Specifies if the service is applied inbound or outbound.
Note WCCP Outbound services are not supported in Cisco IOS XE Release 2.2.
Standard web-cache service
Description of the service which is applied. In this output it is the standard webcache service.
The following is a sample output of the show platform software wccp interface counters command:
Router# show platform software wccp interface counters Interface FastEthernet0/1/0 Input Redirect Packets = 0 Output Redirect Packets = 0The table below describes the significant fields shown in the display.
Table 19 show platform software wccp interface counters Field Descriptions Field
Description
Input Redirect Packets
The number of input packets that have been redirected to the cache engine.
Output Redirect Packets
The number of output packets that have been redirected to the cache engine.
The following is sample output from the show platform software wccp web-cache counters command:
Router# show platform software wccp web-cache counters Service Group (0, 0) counters Unassigned count = 0 Dropped due to closed service count = 0 Bypass count = 0 Bypass failed count = 0 Denied count = 0 Redirect count = 0The table below describes the significant fields shown in the display.
Table 20 show platform software wccp web-cache counters Field Descriptions Field
Description
Unassigned count
Number of packets that were not redirected because they were not assigned to any cache engine. Packets may not be assigned during initial discovery of cache engines or when a cache is dropped from a cluster.
Dropped due to closed service count
Total number of packets that were dropped when WCCP is configured for closed services and an intermediary device is not available to process the service.
Bypass count
The number of packets that have been bypassed.
Bypass failed count
Number of bypass packets that WCCP could not find the original input interface.
Denied count
Total number of packets that were not redirected because they did not match the access list.
Redirect count
Total number of packets redirected by the router.
The following are sample outputs from the show platform software wccp slot active service-number ipv6 command:
Router# show platform software wccp RP active 61 ipv6 IPV6 Dynamic service 61 Priority: 34, Number of clients: 1 Assign Method: Hash, Fwd Method: GRE, Ret Method: GRE L4 proto: 6, Use Source Port: No Is closed: NoRouter# show platform software wccp FP active 61 ipv6 IPV6 Dynamic service 61 Priority: 34, Number of clients: 1 Assign Method: Hash, Fwd Method: GRE, Ret Method: GRE Is closed: No Current ACE: 0, Pending ACE: 0 New ACE: 0, New ACE completed: No ACL id: 0 AOM id: 0x18a, status: createdThe table below describes the significant fields shown in the display.
Table 21 show platform software wccp slot active service-number ipv6 Field Descriptions Field
Description
IPV6 Dynamic service
Specifies the IPv6 Dynamic Service number.
Priority
Specifies the priority of the service group.
Number of clients
Specifies the number of WCCP clients.
Assign Method
Indicates the load-balancing method used (1 for hash and 0 for mask).
Fwd Method
Specifies the WCCP forward method, whether GRE or Layer 2.
Ret Method
Specifies the WCCP return method, whether GRE or Layer 2.
L4 proto
Specifies the Layer 4 protocol. Indicates that the Layer 4 part of the packet is TCP (denoted by 6).
Use Source Port
Specifies whether the service definition uses the source port.
Is closed
Specifies whether WCCP is configured as a closed service or an open service.
Current ACE
Specifies the number of Application Control Engine (ACE) items configured.
Pending ACE
Specifies the pending number of ACE items to be downloaded.
New ACE
Specifies the number of new ACE items to be downloaded.
New ACE completed
Specifies the number of new ACE items downloaded.
ACL id
Identifies the Access Control List (ACL) configured with the WCCP service.
AOM id
Specifies the asynchronous object manager identifier.
status
Specifies the WCCP state.
show sctp association
To display accumulated information for a specific Stream Control Transmission Protocol (SCTP) association, use the show sctp association command in privileged EXEC mode.
Usage Guidelines
This command shows only the information that has become available since the last time a clear sctp statistics command was executed.
Because thousands of associations can be on a single socket and instance ID, this command has been created to limit the output by displaying the status of one particular association ID.
Examples
The following sample output shows the established associations:
Router# show sctp association list ** SCTP Association List ** AssocID: 3011699535, Instance ID: 1 Current state: ESTABLISHED Local port: 2000, Addrs: 10.1.0.1 10.2.0.1 10.3.0.1 10.0.20.105 Remote port: 1000, Addrs: 10.1.0.1 10.2.0.1 10.3.0.1 10.0.20.105 AssocID: 2740019456, Instance ID: 0 Current state: ESTABLISHED Local port: 1000, Addrs: 10.1.0.1 10.2.0.1 10.3.0.1 10.0.20.105 Remote port: 2000, Addrs: 10.1.0.1 10.2.0.1 10.3.0.1 10.0.20.105The following sample output shows information for SCTP association 3011699535:
Router# show sctp association 3011699535 AssocID: 3011699535, Instance ID: 1 Current state: ESTABLISHED Local port: 2000, Addrs: 10.1.0.1 10.2.0.1 10.3.0.1 10.0.20.105 Remote port: 1000, Addrs: 10.1.0.1 10.2.0.1 10.3.0.1 10.0.20.105The table below describes the significant fields shown in the display.
Table 22 show sctp accociation Field Descriptions Field
Description
AssocID/Instance ID
SCTP association identifier and instance identifier.
Current state
State of SCTP association.
Local port
Port number for the local SCTP endpoint.
Remote port
Port number for the remote SCTP endpoint.
Addrs
IP addresses for the local and remote SCTP endpoints.
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp instance
Displays information about SCTP endpoint information for one specific currently configured instance.
show sctp instances
Displays all currently defined SCTP instances.
show sctp statistics
Displays overall statistics counts for SCTP.
show sctp association list
To display identifiers and information for current Stream Control Transmission Protocol (SCTP) associations and instances, use the show sctp association list command in privileged EXEC mode.
Usage Guidelines
Use this command to display the current SCTP association and instance identifiers, the current state of SCTP associations, and the local and remote port numbers and addresses that are used in the associations.
Examples
The following is sample output from this command for three association identifiers:
Router# show sctp association list *** SCTP Association List **** AssocID:0, Instance ID:0 Current state:ESTABLISHED Local port:8989, Addrs:10.1.0.2 10.2.0.2 Remote port:8989, Addrs:10.6.0.4 10.5.0.4 AssocID:1, Instance ID:0 Current state:ESTABLISHED Local port:8989, Addrs:10.1.0.2 10.2.0.2 Remote port:8990, Addrs:10.6.0.4 10.5.0.4 AssocID:2, Instance ID:0 Current state:ESTABLISHED Local port:8989, Addrs:10.1.0.2 10.2.0.2 Remote port:8991, Addrs:10.6.0.4 10.5.0.4The table below describes the significant fields shown in the display.
Table 23 show sctp association list Field Descriptions Field
Description
AssocID
SCTP association identifier.
Instance ID
SCTP association instance identifier.
Current state
SCTP association state, which can be ESTABLISHED, CLOSED, COOKIE-WAIT, and COOKIE-ECHOED.
Local port, Addrs
Port and IP address for the local SCTP endpoint.
Remote port, Addrs
Port and IP address for the remote SCTP endpoint.
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp instances
Displays the currently defined SCTP instances.
show sctp statistics
Displays the overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
show sctp association parameters
To display configured and calculated parameters for the specified Stream Control Transmission Protocol (SCTP) association, use the show sctp association parameters command in privileged EXEC mode.
Usage Guidelines
The show sctp association parameters command provides information to determine the stability of SCTP associations, dynamically calculated statistics about destinations, and values to assess network congestion. This command also displays parameter values for the specified association.
This command requires an association identifier. Association identifiers can be obtained from the output of the show sctp association list command.
Many parameters are defined for each association. Some are configured parameters, and others are calculated. Three main groupings of parameters are displayed by this command:
The association configuration section displays information similar to that in the show sctp association list command, including association identifiers, state, and local and remote port and address information. The current primary destination is also displayed.
Examples
The following sample output shows the IP SCTP association parameters for association 0:
Router# show sctp association parameters 0 ** SCTP Association Parameters ** AssocID: 0 Context: 0 InstanceID: 1 Assoc state: ESTABLISHED Uptime: 19:05:57.425 Local port: 8181 Local addresses: 10.1.0.3 10.2.0.3 Remote port: 8181 Primary dest addr: 10.5.0.4 Effective primary dest addr: 10.5.0.4 Destination addresses: 10.5.0.4: State: ACTIVE Heartbeats: Enabled Timeout: 30000 ms RTO/RTT/SRTT: 1000/16/38 ms TOS: 0 MTU: 1500 cwnd: 5364 ssthresh: 3000 outstand: 768 Num retrans: 0 Max retrans: 5 Num times failed: 0 10.6.0.4: State: ACTIVE Heartbeats: Enabled Timeout: 30000 ms RTO/RTT/SRTT: 1000/4/7 ms TOS: 0 MTU: 1500 cwnd: 3960 ssthresh: 3000 outstand: 0 Num retrans: 0 Max retrans: 5 Num times failed: 0 Local vertag: 9A245CD4 Remote vertag: 2A08D122 Num inbound streams: 10 outbound streams: 10 Max assoc retrans: 5 Max init retrans: 8 CumSack timeout: 200 ms Bundle timeout: 100 ms Min RTO: 1000 ms Max RTO: 60000 ms LocalRwnd: 18000 Low: 13455 RemoteRwnd: 15252 Low: 13161 Congest levels: 0 current level: 0 high mark: 325The table below describes the significant fields shown in the display.
Table 24 show sctp association parameters Field Descriptions Field
Description
AssocID
SCTP association identifier.
Context
Internal upper-layer handle.
InstanceID
SCTP association instance identifier.
Assoc state
SCTP association state, which can be ESTABLISHED, CLOSED, COOKIE-WAIT, and COOKIE-ECHOED.
Uptime
How long the association has been active.
Local port
Port number for the local SCTP endpoint.
Local addresses
IP addresses for the local SCTP endpoint.
Remote port
Port number for the remote SCTP endpoint.
Primary dest addr
Primary destination address.
Effective primary dest addr
Current primary destination address.
Heartbeats
Status of heartbeats.
Timeout
Heartbeat timeout.
RTO/RTT/SRTT
Retransmission timeout, round trip time, and smoothed round trip time, calculated from network feedback.
TOS
IP precedence setting.
MTU
Maximum transmission unit size, in bytes, that a particular interface can handle.
cwnd
Congestion window value calculated from network feedback. This value is the maximum amount of data that can be outstanding in the network for that particular destination.
ssthresh
Slow-start threshold value calculated from network feedback.
outstand
Number of outstanding bytes.
Num retrans
Current number of times that data has been retransmitted to that address.
Max retrans
Maximum number of times that data has been retransmitted to that address.
Num times failed
Number of times that the address has been marked as failed.
Local vertag, Remote vertag
Verification tags (vertags). Tags are chosen during association initialization and do not change.
Num inbound streams, Num outbound streams
Maximum inbound and outbound streams. This number does not change.
Max assoc retrans
Maximum association retransmit limit. Number of times that any particular chunk may be retransmitted before a declaration that the association failed, which indicates that the chunk could not be delivered on any address.
Max init retrans
Maximum initial retransmit limit. Number of times that the chunks for initialization may be retransmitted before a declaration that the attempt to establish the association failed.
CumSack timeout
Cumulative selective acknowledge (SACK) timeout. The maximum time that a SACK may be delayed while attempting to bundle together with data chunks.
Bundle timeout
Maximum time that data chunks may be delayed while attempts are made to bundle them with other data chunks.
Min RTO, Max RTO
Minimum and maximum retransmit timeout values allowed for the association.
LocalRwnd, RemoteRwnd
Local and remote receive windows.
Congest levels: current level, high mark
Current congestion level and highest number of packets queued.
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp instances
Displays all currently defined SCTP instances.
show sctp statistics
Displays overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
show sctp association statistics
To display statistics that have accumulated for the specified Stream Control Transmission Protocol (SCTP) association, use the show sctp association statistics command in privileged EXEC mode.
Usage Guidelines
This command shows only the information that has become available since the last time aclear sctp statistics command was executed.
Examples
The following sample output shows the statistics accumulated for SCTP association 0:
Router# show sctp association statistics 0 ** SCTP Association Statistics ** AssocID/InstanceID: 0/1 Current State: ESTABLISHED Control Chunks Sent: 623874 Rcvd: 660227 Data Chunks Sent Total: 14235644 Retransmitted: 60487 Ordered: 6369678 Unordered: 6371263 Avg bundled: 18 Total Bytes: 640603980 Data Chunks Rcvd Total: 14496585 Discarded: 1755575 Ordered: 6369741 Unordered: 6371269 Avg bundled: 18 Total Bytes: 652346325 Out of Seq TSN: 3069353 ULP Dgrams Sent: 12740941 Ready: 12740961 Rcvd: 12740941The table below describes the significant fields shown in the display.
Table 25 show sctp association statistics Field Descriptions Field
Description
AssocID/InstanceID
SCTP association identifier and instance identifier.
Current State
State of SCTP association.
Control Chunks
SCTP control chunks sent and received.
Data Chunks Sent
SCTP data chunks sent, ordered and unordered.
Data Chunks Rcvd
SCTP data chunks received, ordered and unordered.
ULP Dgrams
Number of datagrams sent, ready, and received by the Upper-Layer Protocol (ULP).
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp instances
Displays all currently defined SCTP instances.
show sctp statistics
Displays overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
show sctp errors
To display the error counts logged by the Stream Control Transmission Protocol (SCTP), use the show sctp errors command in privileged EXEC mode.
Usage Guidelines
This command displays all errors across all associations that have been logged since the last time that the SCTP statistics were cleared with the clear sctp statistics command. If no errors have been logged, this is indicated in the output.
Examples
The following sample output shows a session with no errors:
Router# show sctp errors *** SCTP Error Statistics **** No SCTP errors logged.The following sample output shows a session that has SCTP errors:
Router# show sctp errors ** SCTP Error Statistics ** Invalid verification tag: 5 Communication Lost: 64 Destination Address Failed: 3 Unknown INIT params rcvd: 16 Invalid cookie signature: 5 Expired cookie: 1 Peer restarted: 1 No Listening instance: 2Field descriptions are self-explanatory.
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured for the association defined by the association ID.
show sctp association statistics
Displays the current statistics for the association defined by the association ID.
show sctp instances
Displays the currently defined SCTP instances.
show sctp statistics
Displays overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an AS.
show iua asp
Displays information about the current condition of an ASP.
show sctp instance
To display Stream Control Transmission Protocol (SCTP) endpoint information for one specific currently configured instance, use the show sctp instance command in user EXEC or privileged EXEC mode.
show sctp instance instance-id
Privileged EXEC Mode of Cisco 3845 Series Routers
show sctp instance [redundancy] instance-id
Usage Guidelines
This command displays information for the currently configured instance with the ID specified in the command syntax. The instance number, local port, and address information are displayed. The instance state is either available or deletion pending. An instance enters the deletion pending state when a request is made to delete it but there are currently established associations for that instance. The instance cannot be deleted immediately and instead enters the pending state. No new associations are allowed in this instance, and when the last association is terminated or fails, the instance is deleted.
The default inbound and outbound stream numbers (see the “Examples” section) are used for establishing incoming associations, the maximum number of associations allowed for this instance is shown, and a snapshot of each existing association is shown, if any exists.
Examples
The following sample output displays information for SCTP instance 0. In this example, instance 0 is using local port 1000 and has three current associations. Field description is self-explanatory.
Router# show sctp instance 0 Instance ID:0 Local port:1000 State:available Local addrs:10.1.0.2 10.2.0.2 Default streams inbound:1 outbound:1 Current associations: (max allowed:200) AssocID:0 State:ESTABLISHED Remote port:8989 Dest addrs:10.6.0.4 10.5.0.4 AssocID:1 State:ESTABLISHED Remote port:8990 Dest addrs:10.6.0.4 10.5.0.4 AssocID:2 State:ESTABLISHED Remote port:8991 Dest addrs:10.6.0.4 10.5.0.4The following sample output displays information for SCTP instance 1. In this example, instance 1 is using local port 9191 and has no current associations. Field description is self-explanatory.
Router# show sctp instance 1 Instance ID:1 Local port:9191 State:available Local addrs:10.1.0.2 10.2.0.2 Default streams inbound:1 outbound:1 No current associations established for this instance. Max allowed:6Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show iua as
Displays information about the current condition of an application server.
show iua asp
Displays information about the current condition of an application server process.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp statistics
Displays the overall statistics counts for SCTP.
show sockets
Displays information about sockets.
show sctp instances
To display information for each of the currently configured Stream Control Transmission Protocol (SCTP) instances, use the show sctp instances command in privileged EXEC mode.
Usage Guidelines
This command displays information for each of the currently configured instances. The instance number, local port, and address information are displayed. The instance state is either available or deletion pending. An instance enters the deletion pending state when a request is made to delete it but there are currently established associations for that instance. The instance cannot be deleted immediately and instead enters the pending state. No new associations are allowed in this instance, and when the last association is terminated or fails, the instance is deleted.
The default inbound and outbound stream numbers are used for establishing incoming associations, the maximum number of associations allowed for this instance is shown, and a snapshot of each existing association is shown, if any exists.
When you enter the show sctp instances command, you must type the complete word instances in the command syntax. If you try to enter an abbreviated form of this word, there will be a partial match that identifies the show sctp instance instance-id command.
Examples
The following sample output shows available IP SCTP instances. In this example, two current instances are active and available. The first is using local port 8989, and the second is using 9191. Instance identifier 0 has three current associations, and instance identifier 1 has no current associations.
Router# show sctp instances *** SCTP Instances **** Instance ID:0 Local port:8989 Instance state:available Local addrs:10.1.0.2 10.2.0.2 Default streams inbound:1 outbound:1 Current associations: (max allowed:6) AssocID:0 State:ESTABLISHED Remote port:8989 Dest addrs:10.6.0.4 10.5.0.4 AssocID:1 State:ESTABLISHED Remote port:8990 Dest addrs:10.6.0.4 10.5.0.4 AssocID:2 State:ESTABLISHED Remote port:8991 Dest addrs:10.6.0.4 10.5.0.4 Instance ID:1 Local port:9191 Instance state:available Local addrs:10.1.0.2 10.2.0.2 Default streams inbound:1 outbound:1 No current associations established for this instance. Max allowed:6Field descriptions are self-explanatory.
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured for the association defined by the association identifier.
show sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp statistics
Displays the overall statistics counts for SCTP.
show iua as
Displays information about the current condition of an AS.
show iua asp
Displays information about the current condition of an ASP.
show sctp statistics
To display the overall statistics counts for Stream Control Transmission Protocol (SCTP) activity, use the show sctp statistics command in privileged EXEC mode.
Usage Guidelines
This command displays the overall SCTP statistics accumulated since the last clear sctp statistics command. It includes numbers for all currently established associations, and for any that have been terminated. The statistics indicated are similar to those shown for individual associations.
Examples
The following sample output shows SCTP statistics:
Router# show sctp statistics *** SCTP Overall Statistics **** Total Chunks Sent: 2097 Total Chunks Rcvd: 2766 Data Chunks Rcvd In Seq: 538 Data Chunks Rcvd Out of Seq: 0 Total Data Chunks Sent: 538 Total Data Chunks Rcvd: 538 Total Data Bytes Sent: 53800 Total Data Bytes Rcvd: 53800 Total Data Chunks Discarded: 0 Total Data Chunks Retrans: 0 Total SCTP Dgrams Sent: 1561 Total SCTP Dgrams Rcvd: 2228 Total ULP Dgrams Sent: 538 Total ULP Dgrams Ready: 538 Total ULP Dgrams Rcvd: 538Field descriptions are self-explanatory.
Related Commands
Command
Description
clear sctp statistics
Clears statistics counts for SCTP.
debug ip sctp api
Reports SCTP diagnostic information and messages.
show sctp association list
Displays a list of all current SCTP associations.
show sctp association parameters
Displays the parameters configured and calculated for the association defined by the association identifier.
show sctp association statistics
Displays the current statistics for the association defined by the association identifier.
show sctp errors
Displays error counts logged by SCTP.
show sctp instances
Displays all currently defined SCTP instances.
show iua as
Displays information about the current condition of an AS.
show iua asp
Displays information about the current condition of an ASP.
show sockets
To display IP socket information, use the show sockets command in user EXEC or privileged EXEC mode.
Usage Guidelines
Use this command to display the number of sockets currently open and their distribution with respect to the transport protocol process specified by the process-id argument.
Use the optional detail keyword to display additional information including the local and remote port, protocol type, sub-type for Stream Control Transmission Protocol (SCTP) sockets, IP version, and socket state. Use the optional events keyword to display information about the status of the event model for the specified socket. The events keyword also displays the events being watched using the event model, events being watched using select calls, and any current events present on the socket.
Use the show processes command to display the list of running processes and their associated process IDs.
Examples
The following is sample output from theshow sockets command when there are no sockets open for the specified process:
Router# show sockets 99 There are no open sockets for this processThe following example displays the total number of open sockets for the specified process:
Router# show sockets 35 Total open sockets - TCP:7, UDP:0, SCTP:0The following example shows how to display detailed information about open sockets:
Router# show sockets 35 detail FD LPort FPort Proto Type TransID 0 5000 0 TCP STREAM 0x6654DEBC State: SS_ISBOUND Options: SO_ACCEPTCONN 1 5001 0 TCP STREAM 0x6654E494 State: SS_ISBOUND Options: SO_ACCEPTCONN 2 5002 0 TCP STREAM 0x656710B0 State: SS_ISBOUND Options: SO_ACCEPTCONN 3 5003 0 TCP STREAM 0x65671688 State: SS_ISBOUND Options: SO_ACCEPTCONN 4 5004 0 TCP STREAM 0x65671C60 State: SS_ISBOUND Options: SO_ACCEPTCONN 5 5005 0 TCP STREAM 0x65672238 State: SS_ISBOUND Options: SO_ACCEPTCONN 6 5006 0 TCP STREAM 0x64C7840C State: SS_ISBOUND Options: SO_ACCEPTCONN Total open sockets - TCP:7, UDP:0, SCTP:0The following example displays IP socket event information:
Router# show sockets 35 events Events watched for this process: READ FD Watched Present Select Present 0 --- --- R-- R--The table below describes the significant fields shown in the displays.
Table 26 show sockets Field Descriptions Field
Description
FD
Feasible distance. The feasible distance is the best metric to reach the destination or the best metric that was known when the route went active. This value is used in the feasibility condition check. If the reported distance of the router (the metric after the slash) is less than the feasible distance, the feasibility condition is met and that path is a feasible successor. Once the software determines it has a feasible successor, it need not send a query for that destination.
LPort
Local TCP port.
FPort
Foreign port.
Proto
Protocol type, such as UDP, TCP, or SCTP.
Type
Type of socket being displayed. Possible socket types include:
TransID
Transaction ID number.
State:
Current state of the socket.
Possible socket state flags include:
- SS_NOFDREF--No file descriptor reference for this socket.
- SS_ISCONNECTING--Socket connecting is in progress.
- SS_ISBOUND--Socket is bound to TCP.
- SS_ISCONNECTED--Socket is connected to peer.
- SS_ISDISCONNECTING--Socket disconnecting is in progress.
- SS_CANTSENDMORE--Cannot send more data to peer.
- SS_CANTRCVMORE--Cannot receive more data from peer.
- SS_ISDISCONNECTED--Socket is disconnected. Connection is fully closed.
Options:
Displays socket options. Possible socket options include:
Events watched for this process:
Details the events that are being watched by the application.
READ
Read events being watched by the application.
Watched
Events being watched by the application.
Present
Watched events that are present on the socket.
Select
Events being watched by the application using the select () call.
