Table Of Contents
show bgp ipv6 neighbors
show bgp ipv6 paths
show bgp ipv6 peer-group
show bgp ipv6 prefix-list
show bgp ipv6 quote-regexp
show bgp ipv6 regexp
show bgp ipv6 route-map
show bgp ipv6 summary
show bgp vpnv6 unicast
show call active fax
show call active voice
show call history fax
show call history voice
show cdp entry
show cdp neighbors
show cef
show cef interface
show cef linecard
show cef table
show clns neighbors
show clock
show crypto engine
show crypto ipsec policy
show crypto ipsec sa
show crypto isakmp key
show crypto isakmp peers
show bgp ipv6 neighbors
To display information about IPv6 Border Gateway Protocol (BGP) connections to neighbors, use the show bgp ipv6 neighbors command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} neighbors [ipv6-address] [received-routes | routes |
flap-statistics | advertised-routes | paths regular-expression | dampened-routes]
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
ipv6-address
|
(Optional) Address of the IPv6 BGP-speaking neighbor. If you omit this argument, all IPv6 neighbors are displayed.
This argument must be in the form documented in RFC 2373 where the address is specified in hexadecimal using 16-bit values between colons.
|
received-routes
|
(Optional) Displays all received routes (both accepted and rejected) from the specified neighbor.
|
routes
|
(Optional) Displays all routes received and accepted. This is a subset of the output from the received-routes keyword.
|
flap-statistics
|
(Optional) Displays flap statistics for the routes learned from the neighbor.
|
advertised-routes
|
(Optional) Displays all the routes the networking device advertised to the neighbor.
|
paths regular-expression
|
(Optional) Regular expression used to match the paths received.
|
dampened-routes
|
(Optional) Displays the dampened routes to the neighbor at the IP address specified.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
12.0(21)ST
|
This command was integrated into Cisco IOS Release 12.0(21)ST.
|
12.0(22)S
|
IPv6 capability information was added to the display.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.3(2)T
|
The unicast keyword was added.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The multicast keyword was added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
The show bgp ipv6 unicast neighbors and show bgp ipv6 multicast neighbors commands provide output similar to the show ip bgp neighbors command, except they are IPv6-specific.
The unicast keyword is available in Cisco IOS Release 12.3(2)T and later releases. It is not available in releases prior to 12.3(2)T. Use of the unicast keyword is mandatory starting with Cisco IOS Release 12.3(2)T.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 neighbors command:
Note
The output is the same whether or not the unicast or multicast keyword is used. The unicast keyword is available in Cisco IOS Release 12.3(2)T and Cisco IOS Release 12.0(26)S and later releases, and the multicast keyword is available only in Cisco IOS Release 12.0(26)S and later releases.
Router# show bgp ipv6 unicast neighbors
BGP neighbor is 3FFE:700:20:1::11, remote AS 65003, external link
Member of peer-group 6BONE for session parameters
BGP version 4, remote router ID 192.168.2.27
BGP state = Established, up for 13:40:17
Last read 00:00:09, hold time is 180, keepalive interval is 60 seconds
Route refresh: advertised and received
Address family IPv6 Unicast: advertised and received
Received 31306 messages, 20 notifications, 0 in queue
Sent 14298 messages, 1 notifications, 0 in queue
Default minimum time between advertisement runs is 30 seconds
For address family: IPv6 Unicast
BGP table version 21880, neighbor version 21880
Index 1, Offset 0, Mask 0x2
Route refresh request: received 0, sent 0
Community attribute sent to this neighbor
Outbound path policy configured
Incoming update prefix filter list is bgp-in
Outgoing update prefix filter list is aggregate
Route map for outgoing advertisements is uni-out
77 accepted prefixes consume 4928 bytes
Prefix advertised 4303, suppressed 0, withdrawn 1328
Number of NLRIs in the update sent: max 1, min 0
1 history paths consume 64 bytes
Connections established 22; dropped 21
Last reset 13:47:05, due to BGP Notification sent, hold time expired
Connection state is ESTAB, I/O status: 1, unread input bytes: 0
Local host: 3FFE:700:20:1::12, Local port: 55345
Foreign host: 3FFE:700:20:1::11, Foreign port: 179
Enqueued packets for retransmit: 0, input: 0 mis-ordered: 0 (0 bytes)
Event Timers (current time is 0x1A0D543C):
Timer Starts Wakeups Next
iss: 1805423033 snduna: 1805489354 sndnxt: 1805489354 sndwnd: 15531
irs: 821333727 rcvnxt: 821591465 rcvwnd: 15547 delrcvwnd: 837
SRTT: 300 ms, RTTO: 303 ms, RTV: 3 ms, KRTT: 0 ms
minRTT: 8 ms, maxRTT: 300 ms, ACK hold: 200 ms
Flags: higher precedence, nagle
Datagrams (max data segment is 1420 bytes):
Rcvd: 4252 (out of order: 0), with data: 3328, total data bytes: 257737
Sent: 4445 (retransmit: 5), with data: 4445, total data bytes: 244128
The following is sample output from the show bgp ipv6 neighbors command when the router is configured to allow IPv6 traffic to be transported across an IPv4 Multiprotocol Label Switching (MPLS) network (Cisco 6PE) without any software or hardware upgrade in the IPv4 core infrastructure. A new neighbor capability is added to show that an MPLS label is assigned for each IPv6 address prefix to be advertised. 6PE uses multiprotocol BGP to provide the reachability information for the 6PE routers across the IPv4 network so that the neighbor addresses are IPv4.
Router# show bgp ipv6 unicast neighbors
BGP neighbor is 10.11.11.1, remote AS 65000, internal link
BGP version 4, remote router ID 10.11.11.1
BGP state = Established, up for 04:00:53
Last read 00:00:02, hold time is 15, keepalive interval is 5 seconds
Configured hold time is 15, keepalive interval is 10 seconds
Route refresh: advertised and received(old & new)
Address family IPv6 Unicast: advertised and received
ipv6 MPLS Label capability: advertised and received
Received 67068 messages, 1 notifications, 0 in queue
Sent 67110 messages, 16 notifications, 0 in queue
Default minimum time between advertisement runs is 5 seconds
For address family: IPv6 Unicast
BGP table version 91, neighbor version 91
Index 1, Offset 0, Mask 0x2
Route refresh request: received 0, sent 0
4 accepted prefixes consume 288 bytes
Prefix advertised 90, suppressed 0, withdrawn 2
Number of NLRIs in the update sent: max 3, min 0
Connections established 26; dropped 25
Last reset 04:01:20, due to BGP Notification sent, hold time expired
Connection state is ESTAB, I/O status: 1, unread input bytes: 0
Local host: 10.10.10.1, Local port: 179
Foreign host: 10.11.11.1, Foreign port: 11003
Enqueued packets for retransmit: 0, input: 0 mis-ordered: 0 (0 bytes)
Event Timers (current time is 0x1429F084):
Timer Starts Wakeups Next
iss: 803218558 snduna: 803273755 sndnxt: 803273755 sndwnd: 16289
irs: 4123967590 rcvnxt: 4124022787 rcvwnd: 16289 delrcvwnd: 95
SRTT: 300 ms, RTTO: 303 ms, RTV: 3 ms, KRTT: 0 ms
minRTT: 32 ms, maxRTT: 408 ms, ACK hold: 200 ms
Flags: passive open, nagle, gen tcbs
Datagrams (max data segment is 536 bytes):
Rcvd: 4531 (out of order: 0), with data: 2895, total data bytes: 55215
Sent: 4577 (retransmit: 77, fastretransmit: 0), with data: 2894, total data
Table 62 describes the significant fields shown in the display.
Table 62 show bgp ipv6 neighbors Field Descriptions
Field
|
Description
|
BGP neighbor
|
IP address of the BGP neighbor and its autonomous system number. If the neighbor is in the same autonomous system as the router, then the link between them is internal; otherwise, it is considered external.
|
remote AS
|
Autonomous system of the neighbor.
|
internal link
|
Indicates that this peer is an interior Border Gateway Protocol (iBGP) peer.
|
BGP version
|
BGP version being used to communicate with the remote router; the router ID (an IP address) of the neighbor is also specified.
|
remote router ID
|
A 32-bit number written as 4 octets separated by periods (dotted-decimal format).
|
BGP state
|
Internal state of this BGP connection.
|
up for
|
Amount of time that the underlying TCP connection has been in existence.
|
Last read
|
Time that BGP last read a message from this neighbor.
|
hold time
|
Maximum amount of time that can elapse between messages from the peer.
|
keepalive interval
|
Time period between sending keepalive packets, which help ensure that the TCP connection is up.
|
Neighbor capabilities
|
BGP capabilities advertised and received from this neighbor.
|
Route refresh
|
Indicates that the neighbor supports dynamic soft reset using the route refresh capability.
|
Address family IPv6 Unicast
|
Indicates that BGP peers are exchanging IPv6 reachability information.
|
ipv6 MPLS Label capability
|
Indicates that MPLS labels are being assigned to IPv6 address prefixes.
|
Received
|
Number of total BGP messages received from this peer, including keepalives.
|
notifications
|
Number of error messages received from the peer.
|
Sent
|
Total number of BGP messages that have been sent to this peer, including keepalives.
|
notifications
|
Number of error messages the router has sent to this peer.
|
advertisement runs
|
Value of the minimum advertisement interval.
|
For address family
|
Address family to which the following fields refer.
|
BGP table version
|
Indicates that the neighbor has been updated with this version of the primary BGP routing table.
|
neighbor version
|
Number used by the software to track the prefixes that have been sent and those that must be sent to this neighbor.
|
Route refresh request
|
Number of route refresh requests sent and received from this neighbor.
|
Community attribute (not shown in sample output)
|
Appears if the neighbor send-community command is configured for this neighbor.
|
Inbound path policy (not shown in sample output)
|
Indicates whether an inbound filter list or route map is configured.
|
Outbound path policy (not shown in sample output)
|
Indicates whether an outbound filter list, route map, or unsuppress map is configured.
|
bgp-in (not shown in sample output)
|
Name of the inbound update prefix filter list for the IPv6 unicast address family.
|
aggregate (not shown in sample output)
|
Name of the outbound update prefix filter list for the IPv6 unicast address family.
|
uni-out (not shown in sample output)
|
Name of the outbound route map for the IPv6 unicast address family.
|
accepted prefixes
|
Number of prefixes accepted.
|
Prefix advertised
|
Number of prefixes advertised.
|
suppressed
|
Number of prefixes suppressed.
|
withdrawn
|
Number of prefixes withdrawn.
|
history paths (not shown in sample output)
|
Number of path entries held to remember history.
|
Connections established
|
Number of times the router has established a TCP connection and the two peers have agreed to speak BGP with each other.
|
dropped
|
Number of times that a good connection has failed or been taken down.
|
Last reset
|
Elapsed time (in hours:minutes:seconds) since this peering session was last reset.
|
Connection state
|
State of the BGP peer.
|
unread input bytes
|
Number of bytes of packets still to be processed.
|
Local host, Local port
|
Peering address of the local router, plus the port.
|
Foreign host, Foreign port
|
Peering address of the neighbor.
|
Event Timers
|
Table that displays the number of starts and wakeups for each timer.
|
iss
|
Initial send sequence number.
|
snduna
|
Last send sequence number for which the local host sent but has not received an acknowledgment.
|
sndnxt
|
Sequence number the local host will send next.
|
sndwnd
|
TCP window size of the remote host.
|
irs
|
Initial receive sequence number.
|
rcvnxt
|
Last receive sequence number the local host has acknowledged.
|
rcvwnd
|
TCP window size of the local host.
|
delrecvwnd
|
Delayed receive window—data the local host has read from the connection, but has not yet subtracted from the receive window the host has advertised to the remote host. The value in this field gradually increases until it is larger than a full-sized packet, at which point it is applied to the rcvwnd field.
|
SRTT
|
A calculated smoothed round-trip timeout (in milliseconds).
|
RTTO
|
Round-trip timeout (in milliseconds).
|
RTV
|
Variance of the round-trip time (in milliseconds).
|
KRTT
|
New round-trip timeout (in milliseconds) using the Karn algorithm. This field separately tracks the round-trip time of packets that have been re-sent.
|
minRTT
|
Smallest recorded round-trip timeout (in milliseconds) with hard wire value used for calculation.
|
maxRTT
|
Largest recorded round-trip timeout (in milliseconds).
|
ACK hold
|
Time (in milliseconds) the local host will delay an acknowledgment in order to "piggyback" data on it.
|
Flags
|
IP precedence of the BGP packets.
|
Datagrams: Rcvd
|
Number of update packets received from neighbor.
|
with data
|
Number of update packets received with data.
|
total data bytes
|
Total number of bytes of data.
|
Sent
|
Number of update packets sent.
|
with data
|
Number of update packets with data sent.
|
total data bytes
|
Total number of data bytes.
|
The following is sample output from the show bgp ipv6 neighbors command with the advertised-routes keyword:
Router# show bgp ipv6 unicast neighbors 3FFE:700:20:1::11 advertised-routes
BGP table version is 21880, local router ID is 192.168.7.225
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 2001:200::/35 3FFE:700:20:1::11 0 293 3425 2500 i
*> 2001:208::/35 3FFE:C00:E:B::2 0 237 7610 i
*> 2001:218::/35 3FFE:C00:E:C::2 0 3748 4697 i
The following is sample output from the show bgp ipv6 neighbors command with the routes keyword:
Router# show bgp ipv6 unicast neighbors 3FFE:700:20:1::11 routes
BGP table version is 21885, local router ID is 192.168.7.225
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 2001:200::/35 3FFE:700:20:1::11 0 293 3425 2500 i
* 2001:208::/35 3FFE:700:20:1::11 0 293 7610 i
* 2001:218::/35 3FFE:700:20:1::11 0 293 3425 4697 i
* 2001:230::/35 3FFE:700:20:1::11 0 293 1275 3748 i
Table 63 describes the significant fields shown in the display.
Table 63 show bgp ipv6 neighbors advertised-routes and routes Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
A 32-bit number written as 4 octets separated by periods (dotted-decimal format).
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
• s—The table entry is suppressed.
• d—The table entry is dampened.
• h—The table entry is history.
• *—The table entry is valid.
• >—The table entry is the best entry to use for that network.
• i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
• i—Entry originated from the Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
• e—Entry originated from the Exterior Gateway Protocol (EGP).
• ?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IPv6 address of the network the entry describes.
|
Next Hop
|
IPv6 address of the next system that is used when forwarding a packet to the destination network. An entry of two colons (::) indicates that the router has some non-BGP routes to this network.
|
Metric
|
The value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
The following is sample output from the show bgp ipv6 neighbors command with the paths keyword:
Router# show bgp ipv6 unicast neighbors 3FFE:700:20:1::11 paths ^293
Address Refcount Metric Path
0x6131D7DC 2 0 293 3425 2500 i
0x6132861C 2 0 293 7610 i
0x6131AD18 2 0 293 3425 4697 i
0x61324084 2 0 293 1275 3748 i
0x61320E0C 1 0 293 3425 2500 2497 i
0x61326928 1 0 293 3425 2513 i
0x61320BEC 1 0 293 3425 6509 i
0x6131AAF8 2 0 293 1849 2914 ?
0x61320FE8 1 0 293 1849 1273 209 i
0x613260A8 2 0 293 1849 i
0x6132586C 1 0 293 1849 5539 i
0x6131BBF8 2 0 293 1849 1103 i
0x6132344C 1 0 293 4554 1103 1849 1752 i
0x61324150 2 0 293 1275 559 i
0x6131E5AC 2 0 293 1849 786 i
0x613235E4 1 0 293 1849 1273 i
0x6131D028 1 0 293 4554 5539 8627 i
0x613279E4 1 0 293 1275 3748 4697 3257 i
0x61320328 1 0 293 1849 1273 790 i
0x6131EC0C 2 0 293 1275 5409 i
Note
The caret (^) symbol in the example is a regular expression that is entered by simultaneously pressing the Shift and 6 keys on your keyboard. A caret (^) symbol at the beginning of a regular expression matches the start of a line.
Table 64 describes the significant fields shown in the display.
Table 64 show bgp ipv6 neighbors paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The autonomous system path for that route, followed by the origin code for that route.
|
The following sample output from the show bgp ipv6 neighbors command shows the dampened routes for IPv6 address 3FFE:700:20:1::11:
Router# show bgp ipv6 unicast neighbors 3FFE:700:20:1::11 dampened-routes
BGP table version is 32084, local router ID is 192.168.7.225
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
*d 3FFE:8030::/28 3FFE:700:20:1::11 00:24:20 293 1275 559 8933 i
The following sample output from the show bgp ipv6 neighbors command shows the flap statistics for IPv6 address 3FFE:700:20:1::11:
Router# show bgp ipv6 unicast neighbors 3FFE:700:20:1::11 flap-statistics
BGP table version is 32084, local router ID is 192.168.7.225
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network From Flaps Duration Reuse Path
*d 2001:668::/35 3FFE:700:20:1:: 4923 2d12h 00:59:50 293 1849 3257
*d 3FFE::/24 3FFE:700:20:1:: 4799 2d12h 00:59:30 293 1849 5609 4554
*d 3FFE:8030::/28 3FFE:700:20:1:: 95 11:48:24 00:23:20 293 1275 559 8933
The following sample output from the show bgp ipv6 neighbors command shows the received routes for IPv6 address 2000:0:0:4::2:
Router# show bgp ipv6 unicast neighbors 2000:0:0:4::2 received-routes
BGP table version is 2443, local router ID is 192.168.0.2
Status codes:s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 2000:0:0:1::/64 2000:0:0:4::2 0 2 1 i
*> 2000:0:0:2::/64 2000:0:0:4::2 0 2 i
*> 2000:0:0:2:1::/80 2000:0:0:4::2 0 2 ?
*> 2000:0:0:3::/64 2000:0:0:4::2 0 2 ?
* 2000:0:0:4::1/64 2000:0:0:4::2 0 2 ?
Related Commands
Command
|
Description
|
neighbor activate
|
Enables the exchange of information with a neighboring router.
|
show bgp ipv6 paths
To display all the IPv6 Border Gateway Protocol (BGP) paths in the database, use the show bgp ipv6 paths command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} paths regular-expression
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
regular-expression
|
Regular expression that is used to match the received paths in the database.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
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.3(2)T
|
The unicast keyword was added.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The multicast keyword was added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
The show bgp ipv6 unicast paths and show bgp ipv6 multicast paths commands provide output similar to the show ip bgp paths command, except they are IPv6-specific.
The unicast keyword is available in Cisco IOS Release 12.3(2)T and later releases. It is not available in releases prior to 12.3(2)T. Use of the unicast keyword is mandatory starting with Cisco IOS Release 12.3(2)T.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 paths command:
Note
The output is the same whether or not the unicast or multicast keyword is used. The unicast keyword is available in Cisco IOS Release 12.3(2)T and Cisco IOS Release 12.0(26)S and later, and the multicast keyword is available only in Cisco IOS Release 12.0(26)S and later releases.
Router# show bgp ipv6 unicast paths
Address Hash Refcount Metric Path
0x6131C214 3 2 0 6346 8664 786 i
0x6131D600 13 1 0 3748 1275 8319 1273 209 i
0x613229F0 17 1 0 3748 1275 8319 12853 i
0x61324AE0 18 1 1 4554 3748 4697 5408 i
0x61326818 32 1 1 4554 5609 i
0x61324728 34 1 0 6346 8664 9009 ?
0x61323804 35 1 0 3748 1275 8319 i
0x61327918 35 1 0 237 2839 8664 ?
0x61320504 38 2 0 3748 4697 1752 i
0x61320988 41 2 0 1849 786 i
0x6132245C 46 1 0 6346 8664 4927 i
Table 65 describes the significant fields shown in the display.
Table 65 show bgp ipv6 paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Hash
|
Hash bucket where the path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The autonomous system path for that route, followed by the origin code for that route.
|
show bgp ipv6 peer-group
To display information about Border Gateway Protocol (BGP) peer groups, use the show bgp ipv6 peer-group command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} peer-group [name]
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
name
|
(Optional) Peer group name.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.3(2)T
|
This command was introduced.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The unicast and multicast keywords were added.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
Usage Guidelines
If a user does not specify a peer group name, then all BGP peer groups will be displayed.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 peer-group command:
Router# show bgp ipv6 unicast peer-group
BGP peer-group is external-peerings, remote AS 20
Default minimum time between advertisement runs is 30 seconds
For address family:IPv6 Unicast
BGP neighbor is external-peerings, peer-group external, members:
Index 0, Offset 0, Mask 0x0
Update messages formatted 0, replicated 0
Number of NLRIs in the update sent:max 0, min 0
Table 66 describes the significant fields shown in the display.
Table 66 show bgp ipv6 peer-group Field Descriptions
Field
|
Description
|
BGP peer-group is
|
Type of BGP peer group.
|
remote AS
|
Autonomous system of the peer group.
|
BGP version
|
BGP version being used to communicate with the remote router.
|
For address family: IPv4 Unicast
|
IPv6 unicast-specific properties of this neighbor.
|
show bgp ipv6 prefix-list
To display routes that match a prefix list, use the show bgp ipv6 prefix-list command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} prefix-list name
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
name
|
The specified prefix list.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.3(2)T
|
This command was introduced.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The unicast and multicast keywords were added.
|
Usage Guidelines
The specified prefix list must be an IPv6 prefix list, which is similar in format to an IPv4 prefix list.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 prefix-list command:
Router# show bgp ipv6 unicast prefix-list pin
count:4, range entries:3, sequences:5 - 20, refcount:2
seq 5 permit 747::/16 (hit count:1, refcount:2)
seq 10 permit 747:1::/32 ge 64 le 64 (hit count:2, refcount:2)
seq 15 permit 747::/32 ge 33 (hit count:1, refcount:1)
seq 20 permit 777::/16 le 124 (hit count:2, refcount:1)
The ipv6 prefix-list match the following prefixes:
seq 5: matches the exact match 747::/16
seq 10:first 32 bits in prefix must match with a prefixlen of /64
seq 15:first 32 bits in prefix must match with any prefixlen up to /128
seq 20:first 16 bits in prefix must match with any prefixlen up to /124
Table 67 describes the significant fields shown in the display.
Table 67 show bgp ipv6 prefix-list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
A 32-bit number written as 4 octets separated by periods (dotted-decimal format).
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
• s—The table entry is suppressed.
• d—The table entry is dampened.
• h—The table entry is history.
• *—The table entry is valid.
• >—The table entry is the best entry to use for that network.
• i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
• i—Entry originated from the Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
• e—Entry originated from the Exterior Gateway Protocol (EGP).
• ?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IPv6 address of the network the entry describes.
|
Next Hop
|
IPv6 address of the next system that is used when forwarding a packet to the destination network. An entry of two colons (::) indicates that the router has some non-BGP routes to this network.
|
Metric
|
The value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show bgp ipv6 quote-regexp
To display IPv6 Border Gateway Protocol (BGP) routes matching the autonomous system path regular expression as a quoted string of characters, use the show bgp ipv6 quote-regexp command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} quote-regexp regular-expression
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
regular-expression
|
Regular expression that is used to match the BGP autonomous system paths.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
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.3(2)T
|
The unicast keyword was added.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The multicast keyword was added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
The show bgp ipv6 unicast quote-regexp and show bgp ipv6 multicast quote-regexp commands provide output similar to the show ip bgp quote-regexp command, except they are IPv6-specific.
The unicast keyword is available in Cisco IOS Release 12.3(2)T and later releases. It is not available in releases prior to 12.3(2)T. Use of the unicast keyword is mandatory starting with Cisco IOS Release 12.3(2)T.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 quote-regexp command that shows paths beginning with 33 or containing 293:
Note
The output is the same whether or not the unicast or multicast keyword is used. The unicast keyword is available in Cisco IOS Release 12.3(2)T and Cisco IOS Release 12.0(26)S and later, and the multicast keyword is available only in Cisco IOS Release 12.0(26)S and later releases.
Router# show bgp ipv6 unicast quote-regexp ^33|293
BGP table version is 69964, local router ID is 192.31.7.225
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 2001:200::/35 3FFE:C00:E:4::2 1 0 4554 293 3425 2500 i
* 2001:208::/35 3FFE:C00:E:4::2 1 0 4554 293 7610 i
* 2001:228::/35 3FFE:C00:E:F::2 0 6389 1849 293 2713 i
* 3FFE::/24 3FFE:C00:E:5::2 0 33 1849 4554 i
* 3FFE:100::/24 3FFE:C00:E:5::2 0 33 1849 3263 i
* 3FFE:300::/24 3FFE:C00:E:5::2 0 33 293 1275 1717 i
* 3FFE:C00:E:F::2 0 6389 1849 293 1275
Note
The caret (^) symbol in the example is a regular expression that is entered by pressing the Shift and 6 keys on your keyboard. A caret (^) symbol at the beginning of a regular expression matches the start of a line.
Table 68 describes the significant fields shown in the display.
Table 68 show bgp ipv6 quote-regexp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
A 32-bit number written as 4 octets separated by periods (dotted-decimal format).
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
• s—The table entry is suppressed.
• d—The table entry is dampened.
• h—The table entry is history.
• *—The table entry is valid.
• >—The table entry is the best entry to use for that network.
• i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
• i—Entry originated from the Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
• e—Entry originated from the Exterior Gateway Protocol (EGP).
• ?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IPv6 address of the network the entry describes.
|
Next Hop
|
IPv6 address of the next system that is used when forwarding a packet to the destination network. An entry of two colons (::) indicates that the router has some non-BGP routes to this network.
|
Metric
|
The value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
Related Commands
Command
|
Description
|
show bgp ipv6 regexp
|
Displays IPv6 BGP routes matching the autonomous system path regular expression.
|
show ip bgp regexp
|
Displays routes matching the regular expression.
|
show bgp ipv6 regexp
To display IPv6 Border Gateway Protocol (BGP) routes matching the autonomous system path regular expression, use the show bgp ipv6 regexp command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} regexp regular-expression
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
regular-expression
|
Regular expression that is used to match the BGP autonomous system paths.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
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.3(2)T
|
The unicast keyword was added.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The multicast keyword was added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
Usage Guidelines
The show bgp ipv6 unicast regexp and show bgp ipv6 multicast regexp commands provide output similar to the show ip bgp regexp command, except they are IPv6-specific.
The unicast keyword is available in Cisco IOS Release 12.3(2)T and later releases. It is not available in releases prior to 12.3(2)T. Use of the unicast keyword is mandatory starting with Cisco IOS Release 12.3(2)T.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 regexp command that shows paths beginning with 33 or containing 293:
Note
The output is the same whether or not the unicast or multicast keyword is used. The unicast keyword is available in Cisco IOS Release 12.3(2)T and Cisco IOS Release 12.0(26)S and later, and the multicast keyword is available only in Cisco IOS Release 12.0(26)S and later releases.
Router# show bgp ipv6 unicast regexp ^33|293
BGP table version is 69964, local router ID is 192.168.7.225
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 2001:200::/35 3FFE:C00:E:4::2 1 0 4554 293 3425 2500 i
* 2001:208::/35 3FFE:C00:E:4::2 1 0 4554 293 7610 i
* 2001:228::/35 3FFE:C00:E:F::2 0 6389 1849 293 2713 i
* 3FFE::/24 3FFE:C00:E:5::2 0 33 1849 4554 i
* 3FFE:100::/24 3FFE:C00:E:5::2 0 33 1849 3263 i
* 3FFE:300::/24 3FFE:C00:E:5::2 0 33 293 1275 1717 i
* 3FFE:C00:E:F::2 0 6389 1849 293 1275
Note
The caret (^) symbol in the example is a regular expression that is entered by pressing the Shift and 6 keys on your keyboard. A caret (^) symbol at the beginning of a regular expression matches the start of a line.
Table 69 describes the significant fields shown in the display.
Table 69 show bgp ipv6 regexp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
A 32-bit number written as 4 octets separated by periods (dotted-decimal format).
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
• s—The table entry is suppressed.
• d—The table entry is dampened.
• h—The table entry is history.
• *—The table entry is valid.
• >—The table entry is the best entry to use for that network.
• i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
• i—Entry originated from the Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
• e—Entry originated from the Exterior Gateway Protocol (EGP).
• ?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IPv6 address of the network the entry describes.
|
Next Hop
|
IPv6 address of the next system that is used when forwarding a packet to the destination network. An entry of two colons (::) indicates that the router has some non-BGP routes to this network.
|
Metric
|
The value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show bgp ipv6 route-map
To display IPv6 Border Gateway Protocol (BGP) routes that failed to install in the routing table, use the show bgp ipv6 route-map command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} route-map name
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
name
|
A specified route map to match.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.3(2)T
|
This command was introduced.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The unicast and multicast keywords were added.
|
Usage Guidelines
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 route-map command for a route map named rmap:
Router# show bgp ipv6 unicast route-map rmap
BGP table version is 16, local router ID is 172.30.242.1
Status codes:s suppressed, d damped, h history, * valid, > best, i - internal,
Origin codes:i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*>i12:12::/64 2001:0DB8:101::1 0 100 50 ?
*>i12:13::/64 2001:0DB8:101::1 0 100 50 ?
*>i12:14::/64 2001:0DB8:101::1 0 100 50 ?
*>i543::/64 2001:0DB8:101::1 0 100 50 ?
Table 70 describes the significant fields shown in the display.
Table 70 show bgp ipv6 route-map Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
A 32-bit number written as 4 octets separated by periods (dotted-decimal format).
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
• s—The table entry is suppressed.
• d—The table entry is dampened.
• h—The table entry is history.
• *—The table entry is valid.
• >—The table entry is the best entry to use for that network.
• i—The table entry was learned via an internal BGP session.
• r —A RIB failure has occurred.
• S—The route map is stale.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
• i—Entry originated from the Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
• e—Entry originated from the Exterior Gateway Protocol (EGP).
• ?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IPv6 address of the network the entry describes.
|
Next Hop
|
IPv6 address of the next system that is used when forwarding a packet to the destination network. An entry of two colons (::) indicates that the router has some non-BGP routes to this network.
|
Metric
|
The value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show bgp ipv6 summary
To display the status of all IPv6 Border Gateway Protocol (BGP) connections, use the show bgp ipv6 summary command in user EXEC or privileged EXEC mode.
show bgp ipv6 {unicast | multicast} summary
Syntax Description
unicast
|
Specifies IPv6 unicast address prefixes.
|
multicast
|
Specifies IPv6 multicast address prefixes.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(2)T
|
This command was introduced.
|
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.3(2)T
|
The unicast keyword was added.
|
12.0(26)S
|
The unicast and multicast keywords were added.
|
12.3(4)T
|
The unicast and multicast keywords were added.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB.
|
12.2(25)SG
|
This command was integrated into Cisco IOS Release 12.2(25)SG.
|
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.
|
Cisco IOS XE Release 2.1
|
This command was introduced on Cisco ASR 1000 Series Routers.
|
Usage Guidelines
The show bgp ipv6 unicast summary and show bgp ipv6 multicast summary commands provide output similar to the show ip bgp summary command, except they are IPv6-specific.
The unicast keyword is available in Cisco IOS Release 12.3(2)T and later releases. It is not available in releases prior to 12.3(2)T. Use of the unicast keyword is mandatory starting with Cisco IOS Release 12.3(2)T.
The multicast keyword is available in Cisco IOS Release 12.0(26)S and later releases. It is not available in releases prior to 12.0(26)S. Use of either the unicast or multicast keyword is mandatory starting with Cisco IOS Release 12.0(26)S.
Examples
The following is sample output from the show bgp ipv6 summary command:
Note
The output is the same whether or not the unicast or multicast keyword is used. The unicast keyword is available in Cisco IOS Release 12.3(2)T and Cisco IOS Release 12.0(26)S and later, and the multicast keyword is available only in Cisco IOS Release 12.0(26)S and later releases.
Router# show bgp ipv6 unicast summary
BGP router identifier 172.30.4.4, local AS number 200
BGP table version is 1, main routing table version 1
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
2001:0DB8:101::2 4 200 6869 6882 0 0 0 06:25:24 Active
Table 71 describes the significant fields shown in the display.
.
Table 71 show bgp ipv6 summary Field Descriptions
Field
|
Description
|
BGP router identifier
|
IP address of the networking device.
|
BGP table version
|
Internal version number of the BGP database.
|
main routing table version
|
Last version of BGP database that was injected into the main routing table.
|
Neighbor
|
IPv6 address of a neighbor.
|
V
|
BGP version number spoken to that neighbor.
|
AS
|
Autonomous system.
|
MsgRcvd
|
BGP messages received from that neighbor.
|
MsgSent
|
BGP messages sent to that neighbor.
|
TblVer
|
Last version of the BGP database that was sent to that neighbor.
|
InQ
|
Number of messages from that neighbor waiting to be processed.
|
OutQ
|
Number of messages waiting to be sent to that neighbor.
|
Up/Down
|
The length of time that the BGP session has been in state Established, or the current state if it is not Established.
|
State/PfxRcd
|
Current state of the BGP session/the number of prefixes the router has received from a neighbor or peer group. When the maximum number (as set by the neighbor maximum-prefix command) is reached, the string "PfxRcd" appears in the entry, the neighbor is shut down, and the connection is Idle.
An (Admin) entry with Idle status indicates that the connection has been shut down using the neighbor shutdown command.
|
Related Commands
Command
|
Description
|
clear bgp ipv6
|
Resets an IPv6 BGP TCP connection using BGP soft reconfiguration.
|
neighbor maximum-prefix
|
Controls how many prefixes can be received from a neighbor.
|
neighbor shutdown
|
Disables a neighbor or peer group.
|
show bgp vpnv6 unicast
To display Virtual Private Network (VPN) entries in a Border Gateway Protocol (BGP) table, use the show bgp vpnv6 unicast command in user EXEC or privileged EXEC mode.
show bgp vpnv6 unicast [all | vrf [vrf-name]]
Syntax Description
all
|
(Optional) Displays all entries in a BGP table.
|
vrf
|
(Optional) Specifies all VPN routing and forwarding (VRF) instance tables or a specific VRF table for IPv4 or IPv6 address.
|
vrf-name
|
(Optional) Names a specific VRF table for an IPv4 or IPv6 address.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(33)SRB
|
This command was introduced.
|
12.2(33)SB
|
This command was integrated into Cisco IOS Release 12.2(33)SB.
|
12.2(33)SXI
|
This command was integrated into Cisco IOS Release 12.2(33)SXI.
|
Usage Guidelines
BGP is used for distributing VPN IPv6 routing information in the VPN backbone. The local routes placed in the BGP routing table on an egress provider edge (PE) router are distributed to other PE routers.
Examples
The following examples shows BGP entries from all of the customer-specific IPv6 routing tables:
Router# show bgp vpnv6 unicast all
Network Next Hop Metric LocPrf Weight Path
Route Distinguisher: 100:1
* 2001:100:1:1000::/56 2001:100:1:1000::72a 0 0 200 ?
* i2001:100:1:2000::/56 ::FFFF:200.10.10.1
Route Distinguisher: 200:1
* 2001:100:2:1000::/56 :: 0 32768 ?
* 2001:100:2:2000::/56 ::FFFF:200.10.10.1 0 32768 ?
Table 72 describes the significant fields shown in the displays.
Table 72 show bgp vpnv6 unicast Field Descriptions
Field
|
Description
|
Network
|
IPv6 address of the network the entry describes.
|
Next Hop
|
IPv6 address of the next system that is used when forwarding a packet to the destination network. An entry of two colons (::) indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
Loc Prf
|
Local preference value as configured with the set local-preference command.
|
Weight
|
Weight of the route as set through autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path. At the end of the path is the origin code for the path. It can be one of the following values:
• i—The entry was originated with the IGP and advertised with a network router configuration command.
• e—The route originated with EGP.
• ?—The origin of the path is not clear. Usually this is a path that is redistributed into BGP from an IGP.
|
Route Distinguisher:
|
Specifies the VRF instance.
|
show call active fax
To display call information for T.37 store-and-forward fax transmissions in progress, use the show call active fax command in user EXEC or privileged EXEC mode.
show call active fax [brief [id identifier] | compact [duration {less seconds | more seconds}]
| id identifier]
Syntax Description
brief
|
(Optional) Displays a truncated version of fax call information.
|
id identifier
|
(Optional) Displays only the call with the specified identifier. Range is a hex value from 1 to FFFF.
|
compact
|
(Optional) Displays a compact version of the fax call information.
|
duration
|
(Optional) Displays active calls that are longer or shorter than a specified seconds value. The arguments and keywords are as follows:
• less—Displays calls shorter than the seconds value.
• more—Displays calls longer than the seconds value.
• seconds—Elapsed time, in seconds. Range is from 1 to 2147483647. There is no default value.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.3(1)T
|
This command was introduced on the Cisco 2600 series and Cisco 3600 series.
|
12.0(3)XG
|
This command was modified. Support for Voice over Frame Relay (VoFR) was added.
|
12.0(4)XJ
|
This command was implemented for store-and-forward fax on the Cisco AS5300.
|
12.0(4)T
|
This command was implemented on the Cisco 7200 series.
|
12.0(7)XK
|
This command was implemented on the Cisco MC3810.
|
12.1(2)T
|
This command was integrated into Cisco IOS Release 12.1(2)T.
|
12.1(3)T
|
This command was modified. This command was implemented for modem pass-through over VoIP on the Cisco AS5300.
|
12.1(5)XM
|
This command was implemented on the Cisco AS5800.
|
12.1(5)XM2
|
The command was implemented on the Cisco AS5350 and Cisco AS5400.
|
12.2(2)XB1
|
This command was implemented on the Cisco AS5850.
|
12.2(8)T
|
This command was integrated into Cisco IOS Release 12.2(8)T. Support was not included for the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850.
|
12.2(11)T
|
Support was added for the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850.
|
12.3(14)T
|
This command was modified. T.38 fax relay call statistics were made available to Call Detail Records (CDRs) through vendor-specific attributes (VSAs) and added to the call log.
|
12.4(2)T
|
This command was modified. The LocalHostname display field was added to the VoIP call leg record.
|
12.4(15)T
|
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(16)
|
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(22)T
|
This command was modified. Command output was updated to show IPv6 information.
|
Usage Guidelines
Use this command to display the contents of the active call table. This command displays information about call times, dial peers, connections, quality of service, and other status and statistical information for T.37 store-and-forward fax calls currently connected through the router. This command works with both on-ramp and off-ramp store-and-forward fax functions.
To display information about fax relay calls in progress, use the show call active voice command.
Examples
The following is sample output from the show call active fax command:
Router# show call active fax
ConnectionId[0x37EC7F41 0xB0110001 0x0 0x35C34]
ConnectionId=[0x37EC7F41 0xB0110001 0x0 0x35C34]
Table 73 provides an alphabetical listing of the fields displayed in the output of the show call active fax command and a description of each field.
Table 73 show call active fax Field Descriptions
Field
|
Description
|
ACOM Level
|
Current ACOM level for this call. ACOM is the combined loss achieved by the echo canceler, which is the sum of the Echo Return Loss, Echo Return Loss Enhancement, and nonlinear processing loss for the call.
|
BearerChannel
|
Identification of the bearer channel carrying the call.
|
Buffer Drain Events
|
Total number of jitter buffer drain events.
|
Buffer Fill Events
|
Total number of jitter buffer fill events.
|
CallDuration
|
Length of the call, in hours, minutes, and seconds, hh:mm:ss.
|
CallOrigin
|
Call origin: answer or originate.
|
CallState
|
Current state of the call.
|
ChargedUnits
|
Total number of charging units that apply to this peer since system startup. The unit of measure for this field is hundredths of second.
|
CodecBytes
|
Payload size, in bytes, for the codec used.
|
CoderTypeRate
|
Negotiated coder rate. This value specifies the send rate of voice or fax compression to its associated call leg for this call.
|
ConnectionId
|
Global call identifier for this gateway call.
|
ConnectTime
|
Time, in milliseconds, at which the call was connected.
|
Consecutive-packets-lost Events
|
Total number of consecutive (two or more) packet-loss events.
|
Corrected packet-loss Events
|
Total number of packet-loss events that were corrected using the RFC 2198 method.
|
Dial-Peer
|
Tag of the dial peer sending this call.
|
EchoCancellerMaxReflector=64
|
The location of the largest reflector, in milliseconds (ms). The reflector size does not exceed the configured echo path capacity. For example, if 32 ms is configured, the reflector does not report beyond 32 ms.
|
ERLLevel
|
Current echo return loss (ERL) level for this call.
|
FaxTxDuration
|
Duration of fax transmission from this peer to the voice gateway for this call. You can derive the Fax Utilization Rate by dividing the FaxTxDuration value by the TxDuration value.
|
GapFillWithInterpolation
|
Duration of a voice signal played out with a signal synthesized from parameters, or samples of data preceding and following in time because voice data was lost or not received in time from the voice gateway for this call.
|
GapFillWithPrediction
|
Duration of the voice signal played out with signal synthesized from parameters, or samples of data preceding in time, because voice data was lost or not received in time from the voice gateway for this call. Examples of such pullout are frame-eraser and frame-concealment strategies in G.729 and G.723.1 compression algorithms.
|
GapFillWithRedundancy
|
Duration of a voice signal played out with a signal synthesized from available redundancy parameters because voice data was lost or not received in time from the voice gateway for this call.
|
GapFillWithSilence
|
Duration of a voice signal replaced with silence because voice data was lost or not received in time for this call.
|
GENERIC
|
Generic or common parameters, that is, parameters that are common for VoIP and telephony call legs.
|
H323 call-legs
|
Total H.323 call legs for which call records are available.
|
HiWaterPlayoutDelay
|
High-water-mark Voice Playout FIFO Delay during this call, in ms.
|
Index
|
Dial peer identification number.
|
InfoActivity
|
Active information transfer activity state for this call.
|
InfoType
|
Information type for this call; for example, voice or fax.
|
InSignalLevel
|
Active input signal level from the telephony interface used by this call.
|
Last Buffer Drain/Fill Event
|
Elapsed time since the last jitter buffer drain or fill event, in seconds.
|
LocalHostname
|
Local hostnames used for locally generated gateway URLs.
|
LogicalIfIndex
|
Index number of the logical interface for this call.
|
LoWaterPlayoutDelay
|
Low-water-mark Voice Playout FIFO Delay during this call, in ms.
|
LowerIFName
|
Physical lower interface information. Appears only if the medium is ATM, Frame Relay (FR), or High-Level Data Link Control (HDLC).
|
Media
|
Medium over which the call is carried. If the call is carried over the (telephone) access side, the entry is TELE. If the call is carried over the voice network side, the entry is either ATM, FR, or HDLC.
|
Modem passthrough signaling method in use
|
Indicates that this is a modem pass-through call and that named signaling events (NSEs)—a Cisco-proprietary version of named telephone events in RFC 2833—are used for signaling codec upspeed. The upspeed method is the method used to dynamically change the codec type and speed to meet network conditions. This means that you might move to a faster codec when you have both voice and data calls and then slow down when there is only voice traffic.
|
NoiseLevel
|
Active noise level for this call.
|
OnTimeRvPlayout
|
Duration of voice playout from data received on time for this call. Derive the Total Voice Playout Duration for Active Voice by adding the OnTimeRvPlayout value to the GapFill values.
|
OutSignalLevel
|
Active output signal level to the telephony interface used by this call.
|
PeerAddress
|
Destination pattern or number associated with this peer.
|
PeerId
|
ID value of the peer table entry to which this call was made.
|
PeerIfIndex
|
Voice port index number for this peer. For ISDN media, this would be the index number of the B channel used for this call.
|
PeerSubAddress
|
Subaddress when this call is connected.
|
Percent Packet Loss
|
Total percent packet loss.
|
Port
|
Identification of the time-division multiplexing (TDM) voice port carrying the call.
|
ReceiveBytes
|
Number of bytes received by the peer during this call.
|
ReceiveDelay
|
Average Playout FIFO Delay plus the Decoder Delay during this voice call, in ms.
|
ReceivePackets
|
Number of packets received by this peer during this call.
|
ReleaseSource
|
Number value of the release source.
|
RemoteIPAddress
|
Remote system IP address for the VoIP call.
|
RemoteUDPPort
|
Remote system User Datagram Protocol (UDP) listener port to which voice packets are sent.
|
RoundTripDelay
|
Voice packet round-trip delay between the local and remote systems on the IP backbone for this call.
|
SelectedQoS
|
Selected Resourse Reservation Protocol (RSVP) quality of service (QoS) for this call.
|
SessionProtocol
|
Session protocol used for an Internet call between the local and remote routers through the IP backbone.
|
SessionTarget
|
Session target of the peer used for this call.
|
SetupTime
|
Value of the system UpTime, in milliseconds, when the call associated with this entry was started.
|
SignalingType
|
Signaling type for this call; for example, channel-associated signaling (CAS) or common channel signaling (CCS).
|
SIP call-legs
|
Total Session Initiation Protocol (SIP) call legs for which call records are available.
|
Telephony call-legs
|
Total telephony call legs for which call records are available.
|
Time between Buffer Drain/Fills
|
Minimum and maximum durations between jitter buffer drain or fill events, in seconds.
|
TransmitBytes
|
Number of bytes sent by this peer during this call.
|
TransmitPackets
|
Number of packets sent by this peer during this call.
|
TxDuration
|
The length of the call. Appears only if the medium is TELE.
|
VAD
|
Whether voice activation detection (VAD) was enabled for this call.
|
VoiceTxDuration
|
Duration of voice transmission from this peer to the voice gateway for this call, in ms. Derive the Voice Utilization Rate by dividing the VoiceTxDuration value by the TxDuration value.
|
The following is sample output from the show call active fax brief command:
Router# show call active fax brief
<ID>: <start>hs.<index> +<connect> pid:<peer_id> <dir> <addr> <state> \
tx:<packets>/<bytes> rx:<packets>/<bytes> <state>
IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
delay:<last>/<min>/<max>ms <codec>
FR <protocol> [int dlci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
sig:<on/off> <codec> (payload size)
Tele <int>: tx:<tot>/<v>/<fax>ms <codec> noise:<l> acom:<l> i/o:<l>/<l> dBm
1 : 22021hs.1 +2263 pid:0 Answer wook song active
IP 0.0.0.0 AcceptedMime:2 DiscardedMime:1
1 : 23193hs.1 +1091 pid:3469 Originate 527.... active
Tele : tx:31200/10910/20290ms noise:-1 acom:-1 i/0:0/0 dBm
The following is sample output from the show call active fax command displaying T.38 fax relay statistics:
Router# show call active fax
CallDuration=00:00:44 sec
ConnectionId=[0x6B241E98 0xA78111D8 0x8002000A 0xF4107CA0]
IncomingConnectionId=[0x6B241E98 0xA78111D8 0x8002000A 0xF4107CA0]
FaxRelayMaxJitBufDepth 346
FaxRelayJitterBufOverflow 0
Initial HS Modulation is V.17/long/14400
Recent HS modulation is V.17/short/14400
Direction of transmission is Transmit
Num of Packets TX'ed/RX'ed 932/52
Encapsulation protocol is T.38 (UDPTL)
OriginalCallingNumber=5551234
OriginalCallingOctet=0x80
OriginalCalledNumber=5555678
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=5551234
TranslatedCallingOctet=0x80
TranslatedCalledNumber=5555678
TranslatedCalledOctet=0x80
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=5555678
GwReceivedCalledOctet3=0x80
GwReceivedCallingNumber=5551234
GwReceivedCallingOctet3=0x80
GwReceivedCallingOctet3a=0x0
Table 74 provides an alphabetical listing of the fields displayed in the output of the show call active fax command for T.38 fax relay statistics and a description of each field.
Table 74 show call active fax Field Descriptions for Significant T.38 Fax Relay Statistics
Field
|
Description
|
ACOMLevel
|
Current ACOM level estimate in 0.1 dB increments. The term ACOM is used in G.165, General Characteristics of International Telephone Connections and International Telephone Circuits: Echo Cancellers. ACOM is the combined loss achieved by the echo canceller, which is the sum of the ERL, ERL enhancement, and nonlinear processing loss for the call.
|
BearerChannel
|
Identification of the bearer channel carrying the call.
|
ERLLevel
|
Current ERL level estimate in 0.1 dB increments.
|
FaxRate
|
Fax transmission rate from this peer to the specified dial peer, in bits per second (bps).
|
FaxRelayJitterBufOverflow
|
Fax relay jitter buffer overflow, in ms.
|
FaxRelayMaxJitBufDepth
|
Fax relay maximum jitter buffer depth, in ms.
|
FaxTxDuration
|
Duration of fax transmission from this peer to the voice gateway for this call, in ms.
|
GwReceivedCalledNumber, GwReceivedCalledOctet3
|
Call information received at the gateway.
|
H323 call-legs
|
Type of call: H.323.
|
Initial HS Modulation
|
Initial high speed modulation used.
|
LogicalIfIndex
|
Index number of the logical interface for this call.
|
MGCP call-legs
|
Type of call: Media Gateway Control Protocol (MGCP).
|
Multicast call-legs
|
Type of call: Multicast.
|
OriginalCallingNumber, OriginalCalling Octet, OriginalCalledNumber, OriginalCalledOctet, OriginalRedirectCalledNumber, OriginalRedirectCalledOctet
|
Original call information regarding calling, called, and redirect numbers, and octet-3s. Octet-3s are information elements (IEs) of Q.931 that include type of number, numbering plan indicator, presentation indicator, and redirect reason information.
|
PeerIfIndex
|
Voice port index number for this peer. For ISDN media, this would be the index number of the B channel used for this call.
|
Port
|
Identification of the TDM voice port carrying the call.
|
Recent HS Modulation
|
Most recent high-speed modulation used.
|
SIP call-legs
|
Type of call: SIP.
|
Telephony call-legs
|
Type of call: Telephony.
|
Total call-legs
|
Total calls.
|
TranslatedCallingNumber, TranslatedCallingOctet, TranslatedCalledNumber, TranslatedCalledOctet, TranslatedRedirectCalledNumber, TranslatedRedirectCalledOctet
|
Translated call information.
|
TxDuration
|
Duration of transmit path open from this peer to the voice gateway for this call, in ms.
|
VoiceTxDuration
|
Duration of voice transmission from this peer to the voice gateway for this call, in ms.
|
Related Commands
Command
|
Description
|
show call active voice
|
Displays call information for voice calls that are in progress.
|
show call history
|
Displays the call history table.
|
show call-router routes
|
Displays the dynamic routes in the cache of the BE.
|
show call-router status
|
Displays the Annex G BE status.
|
show voice port
|
Displays configuration information about a specific voice port.
|
show call active voice
To display call information for voice calls in progress, use the show call active voice command in user EXEC or privileged EXEC mode.
show call active voice [brief [called-number number | calling-number number]] | [compact
[duration {less seconds | more seconds}]] | [echo-canceller call-id | id identifier |
media-inactive [called-number number | calling-number number]] | [long-dur-call] |
[redirect {rtpvt | tbct}] | [stats]
Syntax Description
brief
|
(Optional) Displays a truncated version of call information.
|
called-number number
|
(Optional) Displays a specific called number pattern.
|
calling-number number
|
(Optional) Displays a specific calling number pattern.
|
compact
|
(Optional) Displays a compact version of call information.
|
duration
|
(Optional) Displays active calls that are longer or shorter than a specified seconds value. The argument and keywords are as follows:
• less—Displays calls shorter than the seconds value.
• more—Displays calls longer than the seconds value.
• seconds—Elapsed time, in seconds. Range is from 1 to 2147483647. There is no default value.
|
echo-canceller call-id
|
(Optional) Displays information about the state of the extended echo canceller (EC). To query the echo state, you need to know the hex ID in advance. To find the hex ID, enter the show call active voice brief command or use the show voice call status command. Range is from 0 to FFFFFFFF.
|
id identifier
|
(Optional) Displays only the call with the specified identifier value. Range is a hex value from 1 to FFFF.
|
media-inactive
|
(Optional) Displays information about inactive media that have been detected.
|
long-call-dur
|
(Optional) Displays information only for calls with long_duration detected and notified.
|
redirect
|
(Optional) Displays information about active calls that are being redirected using Release-to-Pivot (RTPvt) or Two B-Channel Transfer (TBCT). The keywords are as follows:
• rtpvt—Displays information about RTPvt calls.
• tbct—Displays information about TBCT calls.
|
stats
|
(Optional) Displays informationabout digital signal processing (DSP) voice quality metrics.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.3(1)T
|
This command was introduced on the Cisco 2600 series and Cisco 3600 series.
|
12.0(3)XG
|
Support for Voice over Frame Relay (VoFR) was added.
|
12.0(4)XJ
|
This command was implemented for store-and-forward fax on the Cisco AS5300.
|
12.0(4)T
|
This command was implemented on the Cisco 7200 series.
|
12.0(7)XK
|
This command was implemented on the Cisco MC3810.
|
12.1(2)T
|
This command was integrated into Cisco IOS Release 12.1(2)T.
|
12.1(3)T
|
This command was implemented for modem pass-through over VoIP on the Cisco AS5300.
|
12.1(5)XM
|
This command was implemented on the Cisco AS5800.
|
12.1(5)XM2
|
The command was implemented on the Cisco AS5350 and Cisco AS5400.
|
12.2(2)XB1
|
This command was implemented on the Cisco AS5850.
|
12.2(8)T
|
This command was integrated into Cisco IOS Release 12.2(8)T. Support was not included for the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850.
|
12.2(11)T
|
Support was added for the Cisco AS5300, Cisco AS5350, Cisco AS5400, and Cisco AS5850.
|
12.2(13)T
|
The echo-canceller keyword was added. The command output was modified with an extra reflector location when the extended EC is present; the largest reflector location is shown.
|
12.3(1)
|
The redirect keyword was added.
|
12.3(4)T
|
The called-number, calling-number, and media-inactive keywords were added.
|
12.3(14)T
|
New output relating to Skinny Client Control Protocol (SCCP), SCCP Telephony Control Application (STCAPP), and modem pass-through traffic was added.
|
12.4(2)T
|
This command was modified. The LocalHostname display field was added to the VoIP call leg record and command ouput was enhanced to display modem relay physical layer and error correction protocols.
|
12.4(4)T
|
This command was modifed. The long-dur-call keyword was added to generate show command output that displays only calls with long_duration detected and notified.
|
12.4(11)XW
|
This command was modified. The stats keyword was added.
|
12.4(15)T
|
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(16)
|
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(22)T
|
This command was modified. Command output was updated to show IPv6 information.
|
Usage Guidelines
Use this command to display the contents of the active call table. This command displays information about call times, dial peers, connections, quality of service, and other status and statistical information for voice calls currently connected through the router.
When the extended EC is present, the show call active voice command displays the contents of the Ditech EC_CHAN_CTRL structure. Table 75 contains names and descriptions of the fields in the EC_CHAN_CTRL structure. Table 75 also provides a listing of the information types associated with this command.
Table 75 EC_CHAN_CTRL Field Descriptions
Symbol
|
Field
|
Description
|
BYP0
|
Channel bypass
|
1 = Transparent bypass; EC is disabled.
0 = Cancel; EC is enabled.
|
TAIL3
|
Max tail
|
0 = 24 milliseconds.
1 = 32 milliseconds.
2 = 48 milliseconds.
3 = 64 milliseconds.
Note This field should be set just greater than the anticipated worst round-trip tail delay.
|
REC3
|
Residual echo control
|
0 = Cancel only; echo is the result of linear processing; no nonlinear processing is applied.
1 = Suppress residual; residual echo is zeroed; simple nonlinear processing is applied (you might experience "dead air" when talking).
2 = Reserved.
3 = Generate comfort noise (default).
|
FRZ0
|
h-register hold
|
1 = Freezes h-register; used for testing.
|
HZ0
|
h-register clear
|
Sending the channel command with this bit set clears the h-register.
|
TD3
|
Modem tone disable
|
0 = Ignore 2100 Hz modem answer tone.
1 = G.164 mode (bypass canceller if 2100 Hz tone).
2 = R.
3 = G.165 mode (bypass canceller for phase reversing tone only).
|
ERL0
|
Echo return loss
|
0 = 6 decibel (dB).
1 = 3 dB.
2 = 0 dB.
3 = R. Worst echo return loss (ERL) situation in which canceller still works.
|
HLC1
|
High level compensation
|
0 = No attenuation.
1 = 6 dB if clipped. On loud circuits, the received direction can be attenuated 6 dB if clipping is observed.
|
R0
|
Reserved
|
Must be set to 0 to ensure compatibility with future releases.
|
Use the show call active voice redirect command to monitor any active calls that implement RTPvt or TBCT.
When a call is no longer active, its record is stored. You can display the record by using the show call history voice command.
Examples
The following is sample output from the show call active voice command for modem relay traffic:
Router# show call active voice
Modem Relay Local Rx Speed=0 bps
Modem Relay Local Tx Speed=0 bps
Modem Relay Remote Rx Speed=0 bps
Modem Relay Remote Tx Speed=0 bps
Modem Relay Phy Layer Protocol=v34
Modem Relay Ec Layer Protocol=v14
SPRTTotalInfoBytesReceived=0
The following is sample output from the show call active voice command:
Router# show call active voice
Call agent controlled call-legs: 0
CallDuration=00:00:51 sec
ConnectionId[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
IncomingConnectionId[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
RemoteIPAddress=10.44.44.44
RemoteSignallingIPAddress=10.44.44.44
RemoteSignallingPort=56434
RemoteMediaIPAddress=10.44.44.44
Separate H245 Connection=FALSE
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=70 ms
LoWaterPlayoutDelay=60 ms
PlayDelayClockOffset=212491899
Media Setting=flow-through
OriginalCallingNumber=9193927582
OriginalCallingOctet=0x21
OriginalCalledNumber=93615494
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=9193927582
TranslatedCallingOctet=0x21
TranslatedCalledNumber=93615494
TranslatedCalledOctet=0xC1
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=93615494
GwReceivedCalledOctet3=0xC1
GwReceivedCallingNumber=9193927582
GwReceivedCallingOctet3=0x21
GwReceivedCallingOctet3a=0x81
CallDuration=00:00:53 sec
ConnectionId=[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
IncomingConnectionId=[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
EchoCancellerMaxReflector=8
AlertTimepoint=1073340 ms
OriginalCallingNumber=9193927582
OriginalCallingOctet=0x21
OriginalCalledNumber=93615494
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=9193927582
TranslatedCallingOctet=0x21
TranslatedCalledNumber=93615494
TranslatedCalledOctet=0xC1
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=93615494
GwReceivedCalledOctet3=0xC1
GwOutpulsedCalledNumber=93615494
GwOutpulsedCalledOctet3=0xC1
GwReceivedCallingNumber=9193927582
GwReceivedCallingOctet3=0x21
GwReceivedCallingOctet3a=0x81
GwOutpulsedCallingNumber=9193927582
GwOutpulsedCallingOctet3=0x21
GwOutpulsedCallingOctet3a=0x81
Call agent controlled call-legs: 0
Table 75 describes the significant fields shown in the display.
The following is sample output from the show call active voice command for voice traffic over call-agent controlled call legs. Note that call legs for SCCP telephony endpoints; that is, phones controlled by STCAPP, are displayed under the "Call agent controlled call-legs" field ("SCCP call-legs" displays call legs for devices that are not telephony endpoints; for example, transcoding and conferencing).
Router# show call active voice
Call agent controlled call-legs: 2
CallDuration=00:01:01 sec
ConnectionId=[0x11B1860C 0x22D711D7 0x8014E4D4 0x8FD15327]
IncomingConnectionId=[0x11B1860C 0x22D711D7 0x8014E4D4 0x8FD15327]
EchoCancellerMaxReflector=2
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingOctet=0x0
TranslatedCalledOctet=0x80
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
CallDuration=00:01:03 sec
ConnectionId=[0x0 0x0 0x0 0x0]
IncomingConnectionId=[0x0 0x0 0x0 0x0]
EchoCancellerMaxReflector=2
AlertTimepoint=1559430 ms
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingNumber=7701
TranslatedCallingOctet=0x0
TranslatedCalledNumber=7702
TranslatedCalledOctet=0x0
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
GwOutpulsedCalledNumber=7702
GwOutpulsedCalledOctet3=0x0
GwOutpulsedCallingNumber=7701
GwOutpulsedCallingOctet3=0x0
GwOutpulsedCallingOctet3a=0x0
CallDuration=00:00:00 sec
ConnectionId[0x0 0x0 0x0 0x0]
IncomingConnectionId[0x0 0x0 0x0 0x0]
RemoteIPAddress=10.10.0.0
RemoteSignallingIPAddress=10.10.0.0
RemoteMediaIPAddress=10.2.6.10
tx_DtmfRelay=inband-voice
Separate H245 Connection=FALSE
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=105 ms
LoWaterPlayoutDelay=105 ms
PlayDelayClockOffset=-1662143961
Media Setting=flow-around
Modem passthrough signaling method is nse:
Consecutive-packets-lost Events = 0
Corrected packet-loss Events = 0
Last Buffer Drain/Fill Event = 0sec
Time between Buffer Drain/Fills = Min 0sec Max 0sec
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingOctet=0x0
TranslatedCalledOctet=0x0
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
CallDuration=00:00:00 sec
ConnectionId[0x0 0x0 0x0 0x0]
IncomingConnectionId[0x0 0x0 0x0 0x0]
RemoteSignallingIPAddress=10.10.0.0
RemoteMediaIPAddress=10.2.6.10
tx_DtmfRelay=inband-voice
Separate H245 Connection=FALSE
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=105 ms
LoWaterPlayoutDelay=105 ms
PlayDelayClockOffset=957554296
Media Setting=flow-around
Modem passthrough signaling method is nse:
Consecutive-packets-lost Events = 0
Corrected packet-loss Events = 0
Last Buffer Drain/Fill Event = 0sec
Time between Buffer Drain/Fills = Min 0sec Max 0sec
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingOctet=0x0
TranslatedCalledOctet=0x0
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
Call agent controlled call-legs: 2
The following is sample output from the show call active voice command to indicate if SAF is being used.
Router# show call active voice
ProtocolCallId=7A9E7D9A-EAD311DC-8036BCC4-6EEE85D6@1.5.6.12
The following is sample output from the show call active voice command for fax-relay traffic:
Router# show call active voice
ConnectionId[0xEB630F4B 0x9F5E11D7 0x8008CF18 0xB9C3632]
IncomingConnectionId[0xEB630F4B 0x9F5E11D7 0x8008CF18 0xB9C3632]
RemoteIPAddress=10.7.95.3
RemoteSignallingIPAddress=10.7.95.3
RemoteSignallingPort=1720
RemoteMediaIPAddress=10.7.95.3
tx_DtmfRelay=inband-voice
Separate H245 Connection=FALSE
SessionTarget=ipv4:10.7.95.3
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=110 ms
LoWaterPlayoutDelay=70 ms
Media Setting=flow-through
OriginalCallingNumber=4085550130
OriginalCalledNumber=52930
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x7F
TranslatedCallingNumber=4085550130
TranslatedCallingOctet=0x0
TranslatedCalledNumber=52930
TranslatedCalledOctet=0xE9
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=52930
GwReceivedCalledOctet3=0xE9
GwOutpulsedCalledNumber=52930
GwOutpulsedCalledOctet3=0xE9
GwReceivedCallingNumber=4085452930
GwReceivedCallingOctet3=0x0
GwReceivedCallingOctet3a=0x80
GwOutpulsedCallingNumber=4085550130
GwOutpulsedCallingOctet3=0x0
GwOutpulsedCallingOctet3a=0x80
FaxRelayMaxJitterBufDepth = 0 ms
FaxRelayJitterBufOverFlow = 0
FaxRelayNumberOfPages = 0
Note
Table 75 and Table 77 describe fields in the display.
The following is sample output from the show call active voice brief command:
Router# show call active voice brief
<ID>: <CallID> <start>hs.<index> +<connect> pid:<peer_id> <dir> <addr> <state>
dur hh:mm:ss tx:<packets>/<bytes> rx:<packets>/<bytes>
IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
delay:<last>/<min>/<max>ms <codec>
media inactive detected:<y/n> media cntrl rcvd:<y/n> timestamp:<time>
long_duration_call_detected:<y/n> long duration call duration:n/a timestamp:n/a
MODEMPASS <method> buf:<fills>/<drains> loss <overall%> <multipkt>/<corrected>
last <buf event time>s dur:<Min>/<Max>s
FR <protocol> [int dlci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
ATM <protocol> [int vpi/vci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
Tele <int> (callID) [channel_id] tx:<tot>/<v>/<fax>ms <codec> noise:<l> acom:<l>
i/o:<l>/<l> dBm
MODEMRELAY info:<rcvd>/<sent>/<resent> xid:<rcvd>/<sent> total:<rcvd>/<sent>/<drops>
speeds(bps): local <rx>/<tx> remote <rx>/<tx>
Proxy <ip>:<audio udp>,<video udp>,<tcp0>,<tcp1>,<tcp2>,<tcp3> endpt: <type>/<manf>
bw: <req>/<act> codec: <audio>/<video>
tx: <audio pkts>/<audio bytes>,<video pkts>/<video bytes>,<t120 pkts>/<t120 bytes>
rx: <audio pkts>/<audio bytes>,<video pkts>/<video bytes>,<t120 pkts>/<t120 bytes>
1269 :7587246hs.1 +260 pid:0 Answer active
dur 00:07:14 tx:590/11550 rx:21721/434420
IP 172.29.248.111:17394 rtt:3ms pl:431850/0ms lost:0/0/0 dela
1269 :7587246hs.2 +259 pid:133001 Originate 133001 active
dur 00:07:14 tx:21717/434340 rx:590/11550
Tele 1/0:1 (2):tx:434350/11640/0ms g729r8 noise:-44 acom:-19
The following is an example of the show call active voice command using the echo-canceller keyword. The number 9 represents the hexadecimal ID of an active voice call.
Router# show call active voice echo-canceller 9
Echo canceller control words=6C 0
Bypass=OFF Tail=64 Residual ecan=Comfort noise
Freeze=OFF Modem tone disable=Ignore 2100Hz tone
Worst ERL=6 High level compensation=OFF
Max amplitude reflector (in msec)=5
The following is sample output from the show call active voice echo-canceller command for a call with a hexadecimal ID of 10:
Router# show call active voice echo-canceller 10
Echo canceller control words=6C 0
Bypass=OFF Tail=64 Residual ecan=Comfort noise
Freeze=OFF Modem tone disable=Ignore 2100Hz tone
Worst ERL=6 High level compensation=OFF
Max amplitude reflector (in msec)=64
The call ID number (which is 10 in the previous example) changes with every new active call. When an active call is up, you must enter the show call active voice brief command to obtain the call ID number. The call ID must be converted to hex if you want to use the show call active voice echo-canceller x command (x = call ID converted to hex).
Table 76 shows call ID examples converted to hex (generally incremented by 2):
Table 76 Call IDs Converted to Hex
Decimal
|
Hex
|
| |
|
| |
|
2
|
2
|
4
|
4
|
6
|
6
|
8
|
8
|
10
|
A
|
12
|
C
|
Alternatively, you can use the show voice call status command to obtain the call ID. The call ID output is already in hex form when you use this command:
Router# show voice call status
CallID CID ccVdb Port DSP/Ch Called # Codec Dial-peers
0x1 11CE 0x02407B20 1:0.1 1/1 1000 g711ulaw 2000/1000
The following is sample output from the show call active voice command using the compact keyword:
Router# show call active voice compact
<callID> A/O FAX T<sec> Codec type Peer Address IP R<ip>:<udp>
58 ANS T11 g711ulaw VOIP Psipp 2001:......:230A:6080
59 ORG T11 g711ulaw VOIP P5000110011 10.13.37.150:6090
The following is sample output from the show call active voice redirect command using the tbct keyword:
Router# show call active voice redirect tbct
Maximum no. of TBCT calls allowed:No limit
Maximum TBCT call duration:No limit
Total number TBCT calls currently being monitored = 1
ctrl name=T1-2/0, tag=13, call-ids=(7, 8), start_time=*00:12:25.985 UTC Mon Mar 1 1993
Table 77 describes the significant fields shown in the show call active voice redirect display.
Table 77 show call active voice redirect Field Descriptions
Field
|
Description
|
Maximum no. of TBCT calls allowed
|
Maximum number of calls that can use TBCT as defined by the tbct max calls command.
|
Maximum TBCT call duration
|
Maximum length allowed for a TBCT call as defined by the tbct max call-duration command.
|
Total number TBCT calls currently being monitored
|
Total number of active TBCT calls.
|
ctrl name
|
Name of the T1 controller where the call originated.
|
tag
|
Call tag number that identifies the call.
|
call-ids
|
Numbers that uniquely identify the call legs.
|
start_time
|
Time, in hours, minutes, and seconds, when the redirected call began.
|
Related Commands
Command
|
Description
|
show call active fax
|
Displays call information for fax transmissions that are in progress.
|
show call history
|
Displays the call history table.
|
show call-router routes
|
Displays the dynamic routes in the cache of the BE.
|
show call-router status
|
Displays the Annex G BE status.
|
show dial-peer voice
|
Displays configuration information for dial peers.
|
show num-exp
|
Displays how the number expansions are configured in VoIP.
|
show voice call status
|
Displays the call status for voice ports on the Cisco router or concentrator.
|
show voice port
|
Displays configuration information about a specific voice port.
|
show call history fax
To display the call history table for fax transmissions, use the show call history fax command in user EXEC or privileged EXEC mode.
show call history fax [brief [id identifier] | compact [duration {less | more} time]
| id identifier | last number]
Syntax Description
brief
|
(Optional) Displays a truncated version of the call history table.
|
id identifier
|
(Optional) Displays only the call with the specified identifier. Range is a hex value from 1 to FFFF.
|
compact
|
(Optional) Displays a compact version.
|
duration time
|
(Optional) Displays history information for calls that are longer or shorter than a specified time value. The arguments and keywords are as follows:
• less—Displays calls shorter than the value in the time argument.
• more—Displays calls longer than the value in the time argument.
• time—Elapsed time, in seconds. Range is from 1 to 2147483647.
|
last number
|
(Optional) Displays the last calls connected, where the number of calls that appear is defined by the number argument. Range is from 1 to 100.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.3(1)T
|
This command was introduced on the Cisco 3600 series.
|
12.0(3)XG
|
This command was implemented for Voice over Frame Relay (VoFR) on the Cisco 2600 series and Cisco 3600 series.
|
12.0(4)XJ
|
This command was modified for store-and-forward fax.
|
12.0(4)T
|
This command was modified. The brief keyword was added, and the command was implemented on the Cisco 7200 series.
|
12.0(7)XK
|
This command was modified. The brief keyword was implemented on the Cisco MC3810.
|
12.1(2)T
|
This command was integrated into Cisco IOS Release 12.1(2)T.
|
12.1(5)XM
|
This command was implemented on the Cisco AS5800.
|
12.1(5)XM2
|
This command was implemented on the Cisco AS5350 and Cisco AS5400.
|
12.2(2)XA
|
This command was modified. The output of this command was modified to indicate whether the call in question has been established using Annex E.
|
12.2(4)T
|
This command was integrated into Cisco IOS Release 12.2(4)T.
|
12.2(2)XB1
|
This command was implemented on the Cisco AS5850.
|
12.2(8)T
|
This command was integrated into Cisco IOS Release 12.2(8)T. Support for the Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850 was not included in this release.
|
12.2(11)T
|
This command was implemented on the Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850.
|
12.3(1)
|
This command was modified. The following fields were added: FaxRelayMaxJitterBufDepth, FaxRelayJitterBufOverFlow, FaxRelayHSmodulation, and FaxRelayNumberOfPages.
|
12.3(14)T
|
This command was modified. T.38 fax relay call statistics were made available to Call Detail Records (CDRs) through vendor-specific attributes (VSAs) and added to the call log.
|
12.4(15)T
|
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(16)
|
This command was modified. The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(22)T
|
This command was modified. Command output was updated to show IPv6 information.
|
Usage Guidelines
This command displays a call-history table that contains a list of fax calls connected through the router in descending time order. The maximum number of calls contained in the table can be set to a number from 0 to 500 using the dial-control-mib command in global configuration mode. The default maximum number of table entries is 50. Each call record is aged out of the table after a configurable number of minutes has elapsed, also specified by the dial-control-mib command. The default timer value is 15 minutes.
You can display subsets of the call history table by using specific keywords. To display the last calls connected through this router, use the keyword last, and define the number of calls to be displayed with the number argument.
To display a truncated version of the call history table, use the brief keyword.
This command applies to both on-ramp and off-ramp store-and-forward fax functions.
Examples
The following is sample output from the show call history fax command:
Router# show call history fax
DisconnectText=normal call clearing (16)
ConnectionId=[0xD9ACDFF1 0x9F5D11D7 0x8002CF18 0xB9C3632]
IncomingConnectionId=[0xD9ACDFF1 0x9F5D11D7 0x8002CF18 0xB9C3632]
FaxRelayMaxJitterBufDepth = 0 ms
FaxRelayJitterBufOverFlow = 0
FaxRelayNumberOfPages = 0
OriginalCallingNumber=4085550130
OriginalCalledNumber=52930
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=4085550130
TranslatedCallingOctet=0x0
TranslatedCalledNumber=52930
TranslatedCalledOctet=0xE9
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=52930
GwReceivedCalledOctet3=0xE9
GwReceivedCallingNumber=4085550130
GwReceivedCallingOctet3=0x0
GwReceivedCallingOctet3a=0x80
Table 78 provides an alphabetical listing of the fields displayed in the output of the show call history fax command and a description of each field.
Table 78 show call history fax Field Descriptions
Field
|
Description
|
ACOM Level
|
Current ACOM level for this call. ACOM is the combined loss achieved by the echo canceler, which is the sum of the Echo Return Loss, Echo Return Loss Enhancement, and nonlinear processing loss for the call.
|
BearerChannel
|
Identification of the bearer channel carrying the call.
|
Buffer Drain Events
|
Total number of jitter buffer drain events.
|
Buffer Fill Events
|
Total number of jitter buffer fill events.
|
CallDuration
|
Length of the call, in hours, minutes, and seconds, hh:mm:ss.
|
CallerName
|
Voice port station name string.
|
CallOrigin
|
Call origin: answer or originate.
|
CallState
|
Current state of the call.
|
ChargedUnits
|
Total number of charging units that apply to this peer since system startup. The unit of measure for this field is hundredths of second.
|
CodecBytes
|
Payload size, in bytes, for the codec used.
|
CoderTypeRate
|
Negotiated coder rate. This value specifies the send rate of voice or fax compression to its associated call leg for this call.
|
ConnectionId
|
Global call identifier for this gateway call.
|
ConnectTime
|
Time, in milliseconds (ms), at which the call was connected.
|
Consecutive-packets-lost Events
|
Total number of consecutive (two or more) packet-loss events.
|
Corrected packet-loss Events
|
Total number of packet-loss events that were corrected using the RFC 2198 method.
|
Dial-Peer
|
Tag of the dial peer sending this call.
|
DisconnectCause
|
Cause code for the reason this call was disconnected.
|
DisconnectText
|
Descriptive text explaining the reason for the disconnect.
|
DisconnectTime
|
Time, in ms, when this call was disconnected.
|
EchoCancellerMaxReflector=64
|
The location of the largest reflector, in ms. The reflector size does not exceed the configured echo path capacity. For example, if 32 ms is configured, the reflector does not report beyond 32 ms.
|
ERLLevel
|
Current Echo Return Loss (ERL) level for this call.
|
FaxTxDuration
|
Duration of fax transmission from this peer to the voice gateway for this call. You can derive the Fax Utilization Rate by dividing the FaxTxDuration value by the TxDuration value.
|
FaxRelayJitterBufOverFlow
|
Count of number of network jitter buffer overflows (number of packets). These packets are equivalent to lost packets.
|
FaxRelayMaxJitterBufDepth
|
Maximum depth of jitter buffer (in ms).
|
FaxRelayHSmodulation
|
Most recent high-speed modulation used.
|
FaxRelayNumberOfPages
|
Number of pages transmitted.
|
GapFillWithInterpolation
|
Duration of a voice signal played out with a signal synthesized from parameters, or samples of data preceding and following in time because voice data was lost or not received in time from the voice gateway for this call.
|
GapFillWithRedundancy
|
Duration of a voice signal played out with a signal synthesized from available redundancy parameters because voice data was lost or not received in time from the voice gateway for this call.
|
GapFillWithPrediction
|
Duration of the voice signal played out with signal synthesized from parameters, or samples of data preceding in time, because voice data was lost or not received in time from the voice gateway for this call. Examples of such pullout are frame-eraser and frame-concealment strategies in G.729 and G.723.1 compression algorithms.
|
GapFillWithSilence
|
Duration of a voice signal replaced with silence because voice data was lost or not received in time for this call.
|
GENERIC
|
Generic or common parameters, that is, parameters that are common for VoIP and telephony call legs.
|
GwReceivedCalledNumber, GwReceivedCalledOctet3, GwReceivedCallingNumber, GwReceivedCallingOctet3, GwReceivedCallingOctet3a
|
Call information received at the gateway.
|
H323 call-legs
|
Total H.323 call legs for which call records are available.
|
HiWaterPlayoutDelay
|
High-water-mark Voice Playout FIFO Delay during this call.
|
ImgPages
|
The fax pages that have been processed.
|
Incoming ConnectionId
|
The incoming_GUID. It can be different with ConnectionId (GUID) when there is a long_pound or blast_call feature involved. In those cases, incoming_GUID is unique for all the subcalls that have been generated, and GUID is different for each subcall.
|
Index
|
Dial peer identification number.
|
InfoActivity
|
Active information transfer activity state for this call.
|
InfoType
|
Information type for this call; for example, voice or fax.
|
InSignalLevel
|
Active input signal level from the telephony interface used by this call.
|
Last Buffer Drain/Fill Event
|
Elapsed time since the last jitter buffer drain or fill event, in seconds.
|
LogicalIfIndex
|
Index number of the logical interface for this call.
|
LoWaterPlayoutDelay
|
Low-water-mark Voice Playout FIFO Delay during this call.
|
LowerIFName
|
Physical lower interface information. Appears only if the medium is ATM, Frame Relay (FR), or High-Level Data Link Control (HDLC).
|
Media
|
Medium over which the call is carried. If the call is carried over the (telephone) access side, the entry is TELE. If the call is carried over the voice network side, the entry is either ATM, FR, or HDLC.
|
Modem passthrough signaling method in use
|
Indicates that this is a modem pass-through call and that named signaling events (NSEs)—a Cisco-proprietary version of named telephone events in RFC 2833—are used for signaling codec upspeed. The upspeed method is the method used to dynamically change the codec type and speed to meet network conditions. This means that you might move to a faster codec when you have both voice and data calls and then slow down when there is only voice traffic.
|
NoiseLevel
|
Active noise level for this call.
|
OnTimeRvPlayout
|
Duration of voice playout from data received on time for this call. Derive the Total Voice Playout Duration for Active Voice by adding the OnTimeRvPlayout value to the GapFill values.
|
OriginalCallingNumber, OriginalCalling Octet, OriginalCalledNumber, OriginalCalledOctet, OriginalRedirectCalledNumber, OriginalRedirectCalledOctet
|
Original call information regarding calling, called, and redirect numbers, as well as octet-3s. Octet-3s are information elements (IEs) of Q.931 that include type of number, numbering plan indicator, presentation indicator, and redirect reason information.
|
OutSignalLevel
|
Active output signal level to the telephony interface used by this call.
|
PeerAddress
|
Destination pattern or number associated with this peer.
|
PeerId
|
ID value of the peer table entry to which this call was made.
|
PeerIfIndex
|
Voice port index number for this peer. For ISDN media, this would be the index number of the B channel used for this call.
|
PeerSubAddress
|
Subaddress when this call is connected.
|
Percent Packet Loss
|
Total percent packet loss.
|
Port
|
Identification of the voice port carrying the call.
|
ReceiveBytes
|
Number of bytes received by the peer during this call.
|
ReceiveDelay
|
Average Playout FIFO Delay plus the Decoder Delay during this voice call.
|
ReceivePackets
|
Number of packets received by this peer during this call.
|
ReleaseSource
|
Number value of the release source.
|
RemoteIPAddress
|
Remote system IP address for the VoIP call.
|
RemoteUDPPort
|
Remote system User Datagram Protocol (UDP) listener port to which voice packets are sent.
|
RoundTripDelay
|
Voice packet round-trip delay between the local and remote systems on the IP backbone for this call.
|
SelectedQoS
|
Selected Resource Reservation Protocol (RSVP) quality of service (QoS) for this call.
|
SessionProtocol
|
Session protocol used for an Internet call between the local and remote routers through the IP backbone.
|
SessionTarget
|
Session target of the peer used for this call.
|
SetupTime
|
Value of the system UpTime, in ms, when the call associated with this entry was started.
|
SignalingType
|
Signaling type for this call; for example, channel-associated signaling (CAS) or common-channel signaling (CCS).
|
SIP call-legs
|
Total SIP call legs for which call records are available.
|
Telephony call-legs
|
Total telephony call legs for which call records are available.
|
Time between Buffer Drain/Fills
|
Minimum and maximum durations between jitter buffer drain or fill events, in seconds.
|
TranslatedCallingNumber, TranslatedCallingOctet, TranslatedCalledNumber, TranslatedCalledOctet, TranslatedRedirectCalled Number, TranslatedRedirectCalledOctet
|
Translated call information.
|
TransmitBytes
|
Number of bytes sent by this peer during this call.
|
TransmitPackets
|
Number of packets sent by this peer during this call.
|
TxDuration
|
The length of the call. Appears only if the medium is TELE.
|
VAD
|
Whether voice activation detection (VAD) was enabled for this call.
|
VoiceTxDuration
|
Duration of voice transmission from this peer to the voice gateway for this call. Derive the Voice Utilization Rate by dividing the VoiceTxDuration value by the TxDuration value.
|
The following is sample output from the show call history fax brief command:
Router# show call history fax brief
<ID>: <start>hs.<index> +<connect> +<disc> pid:<peer_id> <direction> <addr>
tx:<packets>/<bytes> rx:<packets>/<bytes> <disc-cause>(<text>)
IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
delay:<last>/<min>/<max>ms <codec>
Telephony <int>: tx:<tot>/<voice>/<fax>ms <codec> noise:<lvl>dBm acom:<lvl>dBm
2 : 5996450hs.25 +-1 +3802 pid:100 Answer 408
tx:0/0 rx:0/0 1F (T30 T1 EOM timeout)
Telephony : tx:38020/38020/0ms g729r8 noise:0dBm acom:0dBm
2 : 5996752hs.26 +-1 +3500 pid:110 Originate uut1@linux2.allegro.com
tx:0/0 rx:0/0 3F (The e-mail was not sent correctly. Remote SMTP server said: 354 )
IP 14.0.0.1 AcceptedMime:0 DiscardedMime:0
3 : 6447851hs.27 +1111 +3616 pid:310 Originate 576341.
tx:11/14419 rx:0/0 10 (Normal connection)
Telephony : tx:36160/11110/25050ms g729r8 noise:115dBm acom:-14dBm
3 : 6447780hs.28 +1182 +4516 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
4 : 6464816hs.29 +1050 +3555 pid:310 Originate 576341.
tx:11/14413 rx:0/0 10 (Normal connection)
Telephony : tx:35550/10500/25050ms g729r8 noise:115dBm acom:-14dBm
4 : 6464748hs.30 +1118 +4517 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
5 : 6507900hs.31 +1158 +2392 pid:100 Answer 4085763413
tx:0/0 rx:3/3224 10 (Normal connection)
Telephony : tx:23920/11580/12340ms g729r8 noise:0dBm acom:0dBm
5 : 6508152hs.32 +1727 +2140 pid:110 Originate uut1@linux2.allegro.com
tx:0/2754 rx:0/0 3F (service or option not available, unspecified)
IP 14.0.0.4 AcceptedMime:0 DiscardedMime:0
6 : 6517176hs.33 +1079 +3571 pid:310 Originate 576341.
tx:11/14447 rx:0/0 10 (Normal connection)
Telephony : tx:35710/10790/24920ms g729r8 noise:115dBm acom:-14dBm
6 : 6517106hs.34 +1149 +4517 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
7 : 6567382hs.35 +1054 +3550 pid:310 Originate 576341.
tx:11/14411 rx:0/0 10 (Normal connection)
Telephony : tx:35500/10540/24960ms g729r8 noise:115dBm acom:-14dBm
7 : 6567308hs.36 +1128 +4517 pid:0 Answer
tx:0/0 rx:0/0 10 (normal call clearing.)
IP 0.0.0.0 AcceptedMime:0 DiscardedMime:0
The following example shows output for the show call history fax command with the T.38 Fax Relay statistics:
Router# show call history fax
DisconnectText=normal call clearing (16)
DisconnectTime=9936000 ms
CallDuration=00:01:00 sec
ConnectionId=[0xD6635DD5 0x9FA411D8 0x8005000A 0xF4107CA0]
IncomingConnectionId=[0xD6635DD5 0x9FA411D8 0x8005000A 0xF4107CA0]
FaxRelayMaxJitterBufDepth=560 ms
FaxRelayJitterBufOverFlow=0
FaxRelayMostRecentHSmodulation=V.17/short/14400
FaxRelayInitHSmodulation=V.17/long/14400
FaxRelayDirection=Transmit
FaxRelayEcmStatus=ENABLED
FaxRelayEncapProtocol=T.38 (UDPTL)
FaxRelayNsfCountryCode=Japan
FaxRelayNsfManufCode=0031B8EE80C48511DD0D0000DDDD0000DDDD000000000000000022ED00B0A400
FaxRelayFaxSuccess=Success
OriginalCallingOctet=0x80
OriginalCalledNumber=41021
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=41023
TranslatedCallingOctet=0x80
TranslatedCalledNumber=41021
TranslatedCalledOctet=0xA1
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=41021
GwReceivedCalledOctet3=0xA1
Table 79 describes the fields not shown in Table 78.
Table 79 show call history fax Field Descriptions
Field
|
Description
|
FaxRelayDirection
|
Direction of fax relay.
|
FaxRelayEcmStatus
|
Fax relay error correction mode status.
|
FaxRelayEncapProtocol
|
Fax relay encapsulation protocol.
|
FaxRelayFaxSuccess
|
Fax relay success.
|
FaxRelayInitHSmodulation
|
Fax relay initial high speed modulation.
|
FaxRelayMostRecentHSmodulation
|
Fax relay most recent high speed modulation.
|
FaxRelayNsfCountryCode
|
Fax relay Nonstandard Facilities (NSF) country code.
|
FaxRelayNsfManufCode
|
Fax relay NSF manufacturers code.
|
FaxRelayPktLossConceal
|
Fax relay packet loss conceal.
|
Related Commands
Command
|
Description
|
dial-control-mib
|
Specifies attributes for the call history table.
|
show call active fax
|
Displays call information for fax transmissions that are in progress.
|
show call active voice
|
Displays call information for voice calls that are in progress.
|
show call history voice
|
Displays the call history table for voice calls.
|
show dial-peer voice
|
Displays configuration information for dial peers.
|
show num-exp
|
Displays how the number expansions are configured in VoIP.
|
show voice port
|
Displays configuration information about a specific voice port.
|
show call history voice
To display the call history table for voice calls, use the show call history voice command in user EXEC or privileged EXEC mode.
show call history voice [brief [id identifier] | compact [duration {less | more} seconds]
| id identifier | last number | redirect {rtpvt | tbct} | stats]
Syntax Description
brief
|
(Optional) Displays a truncated version of the call history table.
|
id identifier
|
(Optional) Displays only the call with the specified identifier. Range is from 1 to FFFF.
|
compact
|
(Optional) Displays a compact version of the call history table.
|
duration seconds
|
(Optional) Displays history information for calls that are longer or shorter than the value of the specified seconds argument. The arguments and keywords are as follows:
• less—Displays calls shorter than the seconds value.
• more—Displays calls longer than the seconds value.
• seconds—Elapsed time, in seconds. Range is from 1 to 2147483647.
|
last number
|
(Optional) Displays the last calls connected, where the number of calls that appear is defined by the number argument. Range is from 1 to 100.
|
redirect
|
(Optional) Displays information about calls that were redirected using Release-to-Pivot (RTPvt) or Two B-Channel Transfer (TBCT). The keywords are as follows:
• rtpvt—Displays information about RTPvt calls.
• tbct—Displays information about TBCT calls.
|
stats
|
(Optional) Displays information about digital signal processing (DSP) voice quality metrics.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.3(1)T
|
This command was introduced on the Cisco 3600 series.
|
12.0(3)XG
|
Support was added for Voice over Frame Relay (VoFR) on the Cisco 2600 series and Cisco 3600 series.
|
12.0(4)XJ
|
This command was modified for store-and-forward fax.
|
12.0(4)T
|
The brief keyword was added, and the command was implemented on the Cisco 7200 series.
|
12.0(5)XK
|
This command was implemented on the Cisco MC3810.
|
12.0(7)XK
|
The brief keyword was implemented on the Cisco MC3810.
|
12.0(7)T
|
This command was integrated into Cisco IOS Release 12.0(7)T.
|
12.1(2)T
|
This command was integrated into Cisco IOS Release 12.1(2)T.
|
12.1(5)XM
|
This command was implemented on the Cisco AS5800.
|
12.1(5)XM2
|
This command was implemented on the Cisco AS5350 and Cisco AS5400.
|
12.2(2)XA
|
The output of this command was modified to indicate whether a specified call has been established using Annex E.
|
12.2(4)T
|
This command was integrated into Cisco IOS Release 12.2(4)T.
|
12.2(2)XB1
|
This command was implemented on the Cisco AS5850.
|
12.2(8)T
|
This command was integrated into Cisco IOS Release 12.2(8)T. Support was not included for the Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850.
|
12.2(11)T
|
Support was added for Cisco AS5350, Cisco AS5400, Cisco AS5800, and Cisco AS5850.
|
12.2(13)T
|
The ReleaseSource field was added to the Field Description table, and the record keyword was deleted from the command name.
|
12.3(1)
|
The redirect keyword was added.
|
12.4(2)T
|
The LocalHostname display field was added to the VoIP call leg record.
|
12.4(11)XW
|
The stats keyword was added.
|
12.4(15)T
|
The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(16)
|
The Port and BearerChannel display fields were added to the TELE call leg record of the command output.
|
12.4(22)T
|
Command output was updated to show IPv6 information.
|
Usage Guidelines
This command displays a call-history table that contains a list of voice calls connected through the router in descending time order. The maximum number of calls contained in the table can be set to a number from 0 to 500 using the dial-control-mib command in global configuration mode. The default maximum number of table entries is 50. Each call record is aged out of the table after a configurable number of minutes has elapsed. The timer value is also specified by the dial-control-mib command. The default timer value is 15 minutes.
You can display subsets of the call history table by using specific keywords. To display the last calls connected through this router, use the last keyword, and define the number of calls to be displayed with the number argument.
To display a truncated version of the call history table, use the brief keyword.
Use the show call active voice redirect command to review records for calls that implemented RTPvt or TBCT.
When a call is active, you can display its statistics by using the show call active voice command.
Examples
The following is sample output from the show call history voice command:
Router# show call history voice
DisconnectText=normal call clearing.
ConnectionId[0x4B091A27 0x3EDD0003 0x0 0xFEFD4]
RemoteIPAddress=10.14.82.14
tx_DtmfRelay=inband-voice
SessionTarget=ipv4:10.14.82.14
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=67 ms
LoWaterPlayoutDelay=67 ms
Modem passthrough signaling method is nse
Consecutive-packets-lost Events = 0
Corrected packet-loss Events = 0
Last Buffer Drain/Fill Event = 373sec
Time between Buffer Drain/Fills = Min 0sec Max 0sec
DisconnectText=normal call clearing.
ConnectionId=[0x4B091A27 0x3EDD0003 0x0 0xFEFD4]
VoiceTxDuration=375300 ms
The following example from a Cisco AS5350 router displays a sample of voice call history records showing release source information:
Router# show call history voice
DisconnectText=normal call clearing (16)
DisconnectText=normal call clearing (16)
ConnectionId[0x2868AD84 0x375B11D4 0x8012F7A5 0x74DE971E]
DisconnectText=normal call clearing (16)
ConnectionId=[0x2868AD84 0x375B11D4 0x8012F7A5 0x74DE971E]
The following is sample output from the show call history voice brief command:
Router# show call history voice brief
<ID>: <CallID> <start>hs.<index> +<connect> +<disc> pid:<peer_id> <direction> <addr>
dur hh:mm:ss tx:<packets>/<bytes> rx:<packets>/<bytes> <disc-cause>(<text>)
IP <ip>:<udp> rtt:<time>ms pl:<play>/<gap>ms lost:<lost>/<early>/<late>
delay:<last>/<min>/<max>ms <codec>
media inactive detected:<y/n> media cntrl rcvd:<y/n> timestamp:<time>
MODEMPASS <method> buf:<fills>/<drains> loss <overall%> <multipkt>/<corrected>
last <buf event time>s dur:<Min>/<Max>s
FR <protocol> [int dlci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
ATM <protocol> [int vpi/vci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
Telephony <int> (callID) [channel_id] tx:<tot>/<voice>/<fax>ms <codec> noise:<lvl>dBm
acom:<lvl>dBm
MODEMRELAY info:<rcvd>/<sent>/<resent> xid:<rcvd>/<sent> total:<rcvd>/<sent>/<drops>
disc:<cause code>
speeds(bps): local <rx>/<tx> remote <rx>/<tx>
Proxy <ip>:<audio udp>,<video udp>,<tcp0>,<tcp1>,<tcp2>,<tcp3> endpt: <type>/<manf>
bw: <req>/<act> codec: <audio>/<video>
tx: <audio pkts>/<audio bytes>,<video pkts>/<video bytes>,<t120 pkts>/<t120 bytes>
rx: <audio pkts>/<audio bytes>,<video pkts>/<video bytes>,<t120 pkts>/<t120 bytes>
The following is sample output from the show call history voice redirect command:
Router# show call history voice redirect tbct
index=2, xfr=tbct-notify, status=redirect_success, start_time=*00:12:25.981 UTC Mon Mar 1
1993, ctrl name=T1-2/0, tag=13
index=3, xfr=tbct-notify, status=redirect_success, start_time=*00:12:25.981 UTC Mon Mar 1
1993, ctrl name=T1-2/0, tag=13
index=4, xfr=tbct-notify, status=redirect_success, start_time=*00:13:07.091 UTC Mon Mar 1
1993, ctrl name=T1-2/0, tag=12
index=5, xfr=tbct-notify, status=redirect_success, start_time=*00:13:07.091 UTC Mon Mar 1
1993, ctrl name=T1-2/0, tag=12
Number of call-legs redirected using tbct with notify:4
Table 80 describes the significant fields shown in the show call history voice redirect tbct display.
Table 80 show call history voice redirect Field Descriptions
Field
|
Description
|
index
|
Index number of the record in the history file.
|
xfr
|
Whether TBCT or TBCT with notify has been invoked.
|
status
|
Status of the redirect request.
|
start_time
|
Time, in hours, minutes, and seconds when the redirected call began.
|
ctrl name
|
Name of the T1 controller where the call originated.
|
tag
|
Call tag number that identifies the call.
|
Number of call-legs redirected using tbct with notify
|
Total number of call legs that were redirected using TBCT with notify.
|
Related Commands
Command
|
Description
|
dial-control-mib
|
Set the maximum number of calls contained in the table.
|
show call active fax
|
Displays call information for fax transmissions that are in progress.
|
show call active voice
|
Displays call information for voice calls that are in progress.
|
show call history fax
|
Displays the call history table for fax transmissions.
|
show dial-peer voice
|
Displays configuration information for dial peers.
|
show num-exp
|
Displays how the number expansions are configured in VoIP.
|
show voice port
|
Displays configuration information about a specific voice port.
|
show cdp entry
To display information about a specific neighboring device discovered using Cisco Discovery Protocol (CDP), use the show cdp entry command in privileged EXEC mode.
show cdp entry {* | device-name[*]} [version] [protocol]
Syntax Description
*
|
Displays all of the CDP neighbors.
|
device-name[*]
|
Name of the neighbor about which you want information. You can enter an optional asterisk (*) at the end of a device-name as a wildcard. For example, entering show cdp entry dev* will match all device names that begin with dev.
|
version
|
(Optional) Limits the display to information about the version of software running on the router.
|
protocol
|
(Optional) Limits the display to information about the protocols enabled on a router.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.2(8)T
|
Support for IPv6 address and address type information was added.
|
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.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
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.
|
Examples
The following is sample output from the show cdp entry command. Information about the neighbor device.cisco.com is displayed, including device ID, protocols and addresses, platform, interface, hold time, and version.
Router# show cdp entry device.cisco.com
Device ID: device.cisco.com
IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local)
IPv6 address: 4000::BC:0:0:C0A8:BC06 (global unicast)
CLNS address: 490001.1111.1111.1111.00
Platform: cisco 3640, Capabilities: Router
Interface: Ethernet0/1, Port ID (outgoing port): Ethernet0/1
Cisco Internetwork Operating System Software
IOS (tm) 3600 Software (C3640-A2IS-M), Experimental Version 12.2
Copyright (c) 1986-2001 by cisco Systems, Inc.
Compiled Wed 08-Aug-01 12:39 by joeuser
Table 81 describes the significant fields shown in the example.
Table 81 show cdp entry Field Descriptions
Field
|
Definition
|
Device ID: device.cisco.com
|
Name or ID of the device.
|
Entry address(es):
|
The IP, IPv6 link-local, IPv6 global unicast, and CLNS addresses.
|
Platform:
|
Platform information specific to the device.
|
Interface: Ethernet0/1, Port ID (outgoing port): Ethernet0/1
|
Information about the interface and port ID interface.
|
Holdtime:
|
Holdtime length in seconds.
|
Version:
|
Information about the software version.
|
The following is sample output from the show cdp entry version command. Only information about the version of software running on device.cisco.com is displayed.
Router# show cdp entry device.cisco.com version
Version information for device.cisco.com:
Cisco Internetwork Operating System Software
IOS (tm) 3600 Software (C3640-A2IS-M), Experimental Version 12.2
Copyright (c) 1986-2001 by cisco Systems, Inc.
Compiled Wed 08-Aug-01 12:39 by joeuser
The following is sample output from the show cdp entry protocol command. Only information about the protocols enabled on device.cisco.com is displayed.
Router# show cdp entry device.cisco.com protocol
Protocol information for device.cisco.com:
IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local)
IPv6 address: 4000::BC:0:0:C0A8:BC06 (global unicast)
CLNS address: 490001.1111.1111.1111.00
Related Commands
Command
|
Description
|
show cdp
|
Displays global CDP information, including timer and hold-time information.
|
show cdp interface
|
Displays information about the interfaces on which CDP is enabled.
|
show cdp neighbors
|
Displays detailed information about neighboring devices discovered using CDP.
|
show cdp traffic
|
Displays traffic information from the CDP table.
|
show cdp neighbors
To display detailed information about neighboring devices discovered using Cisco Discovery Protocol, use the show cdp neighbors command in privileged EXEC mode.
show cdp neighbors [type number] [detail]
Syntax Description
type
|
(Optional) Interface type that is connected to the neighbors about which you want information; possible valid values are ethernet, fastethernet, gigabitethernet, tengigabitethernet, port-channel, and vlan.
|
number
|
(Optional) Number of the interface connected to the neighbors about which you want information.
|
detail
|
(Optional) Displays detailed information about a neighbor (or neighbors) including network address, enabled protocols, hold time, and software version.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0(3)T
|
The output of this command using the detail keyword was expanded to include Cisco Discovery Protocol Version 2 information.
|
12.2(8)T
|
Support for IPv6 address and address type information was added.
|
12.2(14)S
|
Support for IPv6 address and address type information was added.
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command was introduced on the Supervisor Engine 2.
|
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.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.
|
Usage Guidelines
The vlan keyword is supported in Cisco 7600 series routers that are configured with a Supervisor Engine 2.
The port-channel values are from 0 to 282; values from 257 to 282 are supported on the call switching module (CSM) and the firewall services module (FWSM) only.
Examples
The following is sample output from the show cdp neighbors command:
Router# show cdp neighbors
Capability Codes:R - Router, T - Trans Bridge, B - Source Route Bridge S - Switch,
H - Host, I - IGMP, r - Repeater
Device ID Local Intrfce Holdtme Capability Platform Port ID
joe Eth 0 133 R 4500 Eth 0
sam Eth 0 152 R AS5200 Eth 0
terri Eth 0 144 R 3640 Eth0/0
maine Eth 0 141 RP1 Eth 0/0
sancho Eth 0 164 7206 Eth 1/0
Table 81 describes the fields shown in the display.
Table 82 show cdp neighbors Field Descriptions
Field
|
Definition
|
Capability Codes
|
The type of device that can be discovered.
|
Device ID
|
The name of the neighbor device and either the MAC address or the serial number of this device.
|
Local Intrfce
|
The local interface through which this neighbor is connected.
|
Holdtme
|
The remaining amount of time (in seconds) the current device will hold the Cisco Discovery Protocol advertisement from a sending router before discarding it.
|
Capability
|
The type of the device listed in the CDP Neighbors table. Possible values are as follows:
• R—Router
• T—Transparent bridge
• B—Source-routing bridge
• S—Switch
• H—Host
• I—IGMP device
• r—Repeater
|
Platform
|
The product number of the device.
|
Port ID
|
The interface and port number of the neighboring device.
|
The following is sample output for one neighbor from the show cdp neighbors detail command. Additional detail is shown about neighbors, including network addresses, enabled protocols, and software version.
Router# show cdp neighbors detail
Device ID: device.cisco.com
IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local)
IPv6 address: 4000::BC:0:0:C0A8:BC06 (global unicast)
Platform: cisco 3640, Capabilities: Router
Interface: Ethernet0/1, Port ID (outgoing port): Ethernet0/1
Cisco Internetwork Operating System Software
IOS (tm) 3600 Software (C3640-A2IS-M), Version 12.2(25)SEB4, RELE)
VTP Management Domain: `Accounting Group'
Table 83 describes the fields shown in the display.
Table 83 show cdp neighbors detail Field Descriptions
Field
|
Definition
|
Device ID
|
The name of the neighbor device and either the MAC address or the serial number of this device.
|
Entry address(es)
|
A list of network addresses of neighbor devices.
|
IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local)
|
The network address of the neighbor device. The address can be in IP, IPv6, IPX, AppleTalk, DECnet, or Connectionless Network Service (CLNS) protocol conventions.
IPv6 addresses are followed by one of the following IPv6 address types:
• global unicast
• link-local
• multicast
• site-local
• V4 compatible
Note For Cisco IOS Releases12.2(33)SXH3, Release 12.2(33)SXI and later releases, the command will not display the AppleTalk address.
|
Platform
|
The product name and number of the neighbor device.
|
Capabilities
|
The device type of the neighbor. This device can be a router, a bridge, a transparent bridge, a source-routing bridge, a switch, a host, an IGMP device, or a repeater.
|
Interface
|
The local interface through which this neighbor is connected.
|
Port ID
|
The interface and port number of the neighboring device.
|
Holdtime
|
The remaining amount of time (in seconds) the current device will hold the CDP advertisement from a sending router before discarding it.
|
Version
|
The software version of the neighbor device.
|
advertisement version:
|
Version of CDP that is being used for CDP advertisements.
|
Duplex Mode
|
The duplex state of connection between the current device and the neighbor device.
|
Native VLAN
|
The ID number of the VLAN on the neighbor device.
|
VTP Management Domain
|
A string that is the name of the collective group of VLANs associated with the neighbor device.
|
Related Commands
Command
|
Description
|
show cdp
|
Displays global CDP information, including timer and hold-time information.
|
show cdp entry
|
Displays information about a specific neighbor device listed in the CDP table.
|
show cdp interface
|
Displays information about the interfaces on which CDP is enabled.
|
show cdp traffic
|
Displays information about traffic between devices gathered using CDP.
|
show cef
To display information about packets forwarded by Cisco Express Forwarding, use the show cef command in privileged EXEC mode.
show cef {accounting | background [detail] | broker broker-name [detail] | error | fib |
hardware vectors | idb | loadinfo | non-ip | nsf | path [list [walk] | sets [detail | id path-set-id
| summary] | switching background [detail] | walks [process | queue]}
Syntax Description
accounting
|
Displays Cisco Express Forwarding accounting state.
|
background
|
Displays Cisco Express Forwarding background processing.
|
detail
|
(Optional) Displays detailed Cisco Express Forwarding information.
|
broker broker-name
|
(Distributed platforms only) Displays Cisco Express Forwarding information related to update brokers.
|
error
|
Displays information about the state of Cisco Express Forwarding errors.
|
fib
|
Displays Cisco Express Forwarding Forwarding Information Base (FIB) entries.
|
hardware vectors
|
Displays the hardware application programming interface (API) vector function table.
|
idb
|
Displays Cisco Express Forwarding interface descriptor blocks.
|
loadinfo
|
Displays Cisco Express Forwarding loadinfo events.
|
non-ip
|
Displays Cisco Express Forwarding paths for non-IP traffic.
|
nsf
|
(Distributed platforms only) Displays Cisco Express Forwarding nonstop forwarding (NSF) statistics.
|
path
|
Displays Cisco Express Forwarding paths.
|
list
|
(Optional) Displays a list of Cisco Express Forwarding paths.
|
walk
|
(Optional) Displays the walk through the list of Cisco Express Forwarding paths.
|
sets
|
(Optional) Displays point-to-multipoint path set information.
|
detail
|
(Optional) Displays detailed point-to-multipoint path set information.
|
id path-set-id
|
(Optional) Displays information about the specified path set. Enter the path set ID in hex format.
|
summary
|
(Optional) Displays high-level information about point-to-multipoint path sets.
|
switching background
|
Display Cisco Express Forwarding background switching processing.
|
walks
|
Specifies a walk through Cisco Express Forwarding infrastructure.
|
process
|
(Optional) Displays the process that services the background work queue.
|
queue
|
(Optional) Displays the work queue of background walks.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.2GS
|
This command was introduced to support the Cisco 12012 Internet router.
|
11.1CC
|
Support was added for multiple platforms.
|
12.0(22)S
|
The display output for this command was modified to include support for Cisco Express Forwarding for IPv6 and distributed Cisco Express Forwarding for IPv6 packets.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(25)S
|
The drop and not-cef-switched keywords were removed. The accounting, background, broker, fib, hardware vectors, idb, loadinfo, non-ip, nsf, path, and walks keywords were added.
|
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.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)SRE
|
This command was modified. The sets keyword was added to display point-to-multipoint information.
|
Usage Guidelines
Use this command to display and monitor information about traffic forwarded by Cisco Express Forwarding.
A line card might drop packets because of encapsulation failure, absence of route information, or absence of adjacency information.
A packet is punted (sent to another switch path) because Cisco Express Forwarding may not support a specified encapsulation or feature, the packet may be destined for the router, or the packet may have IP options (such as time stamp and record route). IP options are process switched.
Examples
The following example shows how to display Cisco Express Forwarding accounting information:
Router# show cef accounting
Enabled accounting: per-prefix, non-recursive, prefix-length
Non-recursive load interval: 30 (default 30)
Non-recursive update interval: 0 (default 0)
Non-recursive load interval: 30 (default 30)
Non-recursive update interval: 0 (default 0)
Table 84 describes the significant fields shown in the example.
Table 84 show cef accounting Field Descriptions
Field
|
Description
|
Enabled accounting
|
Type or types of Cisco Express Forwarding accounting that are enabled: load-balance-hash, non-recursive, per-prefix, prefix-length, or none.
|
per-prefix
|
Indicates that Cisco Express Forwarding accounting is enabled for the collection of the number of packets and bytes express-forwarded to a destination (or prefix).
|
non-recursive
|
Indicates that Cisco Express Forwarding accounting is enabled through nonrecursive prefixes.
|
prefix-length
|
Indicates that Cisco Express Forwarding accounting is enabled through prefix length.
|
The following example shows how to display Cisco Express Forwarding background information:
Router# show cef background
CEF background process process (pid 77) running
0 events awaiting registration on background process
9 events registered on background process
boolean FIB malloc failed, 0 occurences
boolean FIB assert failed, 0 occurences
boolean FIB hw_api_failure failed, 0 occurences
timer FIB checkers: auto-repair delay, init, !run, 0 occurences
timer FIB checkers: auto-repair delay, init, !run, 0 occurences
timer FIB checkers: IPv4 scan-rib-ios scanner, init, run, 2 occurences
timer FIB checkers: IPv4 scan-ios-rib scanner, init, run, 2 occurences
timer FIB checkers: IPv6 scan-ios-rib scanner, init, run, 2 occurences
timer FIB table: rate monitor, init, run, 0 occurences
Table 85 describes the significant fields shown in the example.
Table 85 show cef background Field Descriptions
Field
|
Description
|
boolean
|
The background process is waiting for a true or false flag to be set.
|
FIB malloc failed, 0 occurences
|
No instances of memory allocation failure have occurred for the FIB.
|
FIB assert failed, 0 occurences
|
No instances of assertion failure have occurred for the FIB.
|
FIB hw_api_failure failed; 0 occurences
|
No failures are reported during the programming of hardware forwarding.
|
timer
|
The background process is waiting for a timer to be triggered. Once the timer is triggered, the operation begins. In the FIB checkers cases that follow, the timer is linked to Cisco Express Forwarding consistency checkers.
|
FIB checkers: auto-repair delay, init, !run, 0 occurences
|
FIB auto repair timer is initialized, but the timer is not running and has not been running (0 occurences).
|
FIB checkers: IPv4 scan-rib-ios scanner, init, !run, 2 occurences
|
FIB IPv4 scan-rib-ios timer is initialized and running. The timer has been triggered twice.
|
FIB checkers: IPv4 scan-ios-rib scanner, init, run, 2 occurences
|
FIB IPv4 scan-ios-rib timer is initialized and running. The timer has been triggered twice.
|
FIB table: rate monitor, init, run, 0 occurences
|
FIB table rate monitor timer is initialized and running, but has yet to be triggered.
|
The following example shows how to display information about Cisco Express Forwarding FIB entries:
9 allocated IPv4 entries, 0 failed allocations
1 allocated IPv6 entry, 0 failed allocations
Table 86 describes the significant fields shown in the example.
Table 86 show cef fib Field Descriptions
Field
|
Description
|
9 allocated IPv4 entries, 0 failed allocations
|
Number of successfully allocated and failed IPv4 entries.
|
1 allocated IPv6 entry, 0 failed allocations
|
Number of successfully allocated and failed IPv6 entries.
|
The following example shows how to display information about Cisco Express Forwarding loadinfo:
Router# show cef loadinfo
0 allocated loadinfos, 0 failed allocations
0 allocated loadinfo hash usage gsbs
0 inplace modifies (enabled)
Table 87 describes the significant fields shown in the example.
Table 87 show cef loadinfo Field Descriptions
Field
|
Description
|
0 allocated loadinfos, 0 failed allocations
|
Number of successfully allocated and failed allocated loadinfos.
|
0 allocated loadinfo hash usage gsbs
|
Number of allocated subblocks for per-hash bucket accounting when load balancing is used.
|
0 inplace modifies (enabled)
|
In-place modification is enabled. No in-place modifications have occurred.
|
0 identical modifies
|
Number of in-place modifications that were skipped because the replacement was identical to the target.
|
The following example shows how to display information for Cisco Express Forwarding paths:
28 allocated IPv4 paths, 0 failed allocations
4 allocated IPv6 paths, 0 failed allocations
32 Total Paths, 587 Recursive Paths, 0 Unresolved Paths
Table 88 describes the significant fields shown in the example.
Table 88 show cef path Field Descriptions
Field
|
Definition
|
28 allocated IPv4 paths
|
Number of successfully allocated and failed IPv4 paths.
|
4 allocated IPv6 paths
|
Number of successfully allocated and failed IPv4 paths.
|
32 Total Paths, 587 Recursive Paths, 0 Unresolved Paths
|
Information on all Cisco Express Forwarding paths.
|
The following example shows how to display information about Cisco Express Forwarding background switching processes:
Router# show cef switching background
CEF switching background process (pid 46) running
0 events awaiting registration on background process
1 event registered on background process
boolean OCE unlock queue, 0 occurences
Table 89 describes the significant fields shown in the example.
Table 89 show cef switching background Field Descriptions
Field
|
Description
|
0 events awaiting registration on background process
|
Number of events waiting to be registered on the background process.
|
1 event registered on background process
|
Number of events registered on the background process.
|
boolean OCE unlock queue, 0 occurences
|
Number of output chain element (OCE) unlock queue events.
|
The following example shows how to display information about Cisco Express Forwarding:
mode / priority low high very high
mode / priority low high very high
mode / priority low high very high
mode / priority low high very high
mode / priority low high very high
Table 90 describes the significant fields shown in the example.
Table 90 show cef walks Field Description
Field
|
Description
|
mode
|
Indicates the mode of the Cisco Express Forwarding infrastructure walk:
• sync—The walk takes place in the current process context and completes before the start function returns. Other processes are allowed to run.
• atomic—The walk takes place in the current process context and completes before the start function returns. No other processes are allowed to run.
|
priority
|
Indicate the priority of the infrastructure walk: low, medium, or high.
|
Related Commands
Command
|
Description
|
clear cef linecard
|
Clears Cisco Express Forwarding information from line cards.
|
show cef features global
|
Displays Cisco Express Forwarding features for any interface.
|
show cef interface
|
Displays detailed Cisco Express Forwarding information for a specified interface or for all interfaces.
|
show cef linecard
|
Displays Cisco Express Forwarding-related information by line card.
|
show cef memory
|
Displays information about Cisco Express Forwarding memory usage.
|
show cef state
|
Displays the state of Cisco Express Forwarding on a networking device.
|
show cef subtree context client
|
Displays Cisco Express Forwarding prefix subtrees.
|
show cef table
|
Displays the configuration and operational state of the Cisco Express Forwarding FIB table.
|
show cef timers
|
Displays the current state of the timers internal to the Cisco Express Forwarding process.
|
show cef interface
To display detailed Cisco Express Forwarding information for a specified interface or for all interfaces, use the show cef interface command in user EXEC or privileged EXEC mode.
show cef interface [type number] [statistics | detail | internal | brief | policy-statistics [input |
output]]
Syntax Description
type number
|
(Optional) Interface type and number.
No space is required between the interface type and number.
|
statistics
|
(Optional) Displays switching statistics for an interface or interfaces.
|
detail
|
(Optional) Displays detailed Cisco Express Forwarding information for the specified interface type and number.
|
internal
|
(Optional) Displays internal Cisco Express Forwarding interface status and configuration.
|
brief
|
(Optional) Summarizes the Cisco Express Forwarding interface state.
|
policy-statistics
|
(Optional) Displays Border Gateway Protocol (BGP) policy statistical information for a specific interface or for all interfaces.
|
input
|
(Optional) Displays BGP accounting policy statistics for traffic that is traveling through an input interface.
|
output
|
(Optional) Displays BGP accounting policy statistics for traffic that is traveling through an output interface.
|
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.2GS
|
This command was introduced to support the Cisco 12012 Internet router.
|
11.1CC
|
Support for multiple platforms was added.
|
12.0(14)ST
|
This command was integrated into Cisco IOS Release 12.0(14)ST, and the statistics keyword was added.
|
12.2(2)T
|
This command was integrated into Cisco IOS Releas |