Cisco IOS IPv6 Command Reference
show bgp ipv6 neighbors through show crypto isakmp peers

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
  Neighbor capabilities:
    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
  6BONE peer-group member
  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
Retrans          1218          5             0x0
TimeWait            0          0             0x0
AckHold          3327       3051             0x0
SendWnd             0          0             0x0
KeepAlive           0          0             0x0
GiveUp              0          0             0x0
PmtuAger            0          0             0x0
DeadWait            0          0             0x0

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
  Neighbor capabilities:
    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
  Sending Prefix & Label
  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
Retrans          2971         77             0x0
TimeWait            0          0             0x0
AckHold          2894       1503             0x0
SendWnd             0          0             0x0
KeepAlive           0          0             0x0
GiveUp              0          0             0x0
PmtuAger            0          0             0x0
DeadWait            0          0             0x0

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 
bytes: 55215

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
0x61327BC0        2      0 293 i
0x61321758        1      0 293 145 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

   Network          From             Reuse    Path
*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
0x61322A78    0        2      0 i
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
  BGP version 4
  Default minimum time between advertisement runs is 30 seconds

 For address family:IPv6 Unicast
  BGP neighbor is external-peerings, peer-group external, members:
  1::1 
  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

ipv6 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:0DB8:0:F004::1
                                                           0 3320 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:0DB8:0:F004::1
                                                           0 3320 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,
              r RIB-failure, S Stale
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 ?
*                         ::                0                      32768 ?
*  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

GENERIC:
SetupTime=22021 ms
Index=1
PeerAddress=peer one
PeerSubAddress=
PeerId=0
PeerIfIndex=0
LogicalIfIndex=0
ConnectTime=24284
CallState=4
CallOrigin=2
ChargedUnits=0
InfoType=10
TransmitPackets=0
TransmitBytes=0
ReceivePackets=0
ReceiveBytes=41190

MMOIP:
ConnectionId[0x37EC7F41 0xB0110001 0x0 0x35C34]
CallID=1
RemoteIPAddress=10.0.0.0
SessionProtocol=SMTP
SessionTarget=
MessageId=
AccountId=
ImgEncodingType=MH
ImgResolution=fine
AcceptedMimeTypes=2
DiscardedMimeTypes=1
Notification=None

GENERIC:
SetupTime=23193 ms
Index=1
PeerAddress=527....
PeerSubAddress=
PeerId=3469
PeerIfIndex=157
LogicalIfIndex=30
ConnectTime=24284
CallState=4
CallOrigin=1
ChargedUnits=0
InfoType=10
TransmitPackets=5
TransmitBytes=6513
ReceivePackets=0
ReceiveBytes=0

TELE:    
ConnectionId=[0x37EC7F41 0xB0110001 0x0 0x35C34]
CallID=2
Port=3/0/0 (2)
BearerChannel=3/0/0.1
TxDuration=24010 ms
FaxTxDuration=10910 ms
FaxRate=14400
NoiseLevel=-1
ACOMLevel=-1
OutSignalLevel=0
InSignalLevel=0
InfoActivity=0
ERLLevel=-1
SessionTarget=
ImgPages=0

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
tx:0/0 rx:0/41190
IP 0.0.0.0 AcceptedMime:2 DiscardedMime:1
 
1    : 23193hs.1 +1091 pid:3469 Originate 527.... active
tx:10/13838 rx:0/0
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

Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 0
MGCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 1

 GENERIC:
SetupTime=1874690 ms
Index=1
PeerAddress=5551234
PeerSubAddress=
PeerId=3
PeerIfIndex=244
LogicalIfIndex=118
ConnectTime=187875
CallDuration=00:00:44 sec
CallState=4
CallOrigin=2
ChargedUnits=0
InfoType=fax
TransmitPackets=309
TransmitBytes=5661
ReceivePackets=1124
ReceiveBytes=49189
TELE:
ConnectionId=[0x6B241E98 0xA78111D8 0x8002000A 0xF4107CA0]
IncomingConnectionId=[0x6B241E98 0xA78111D8 0x8002000A 0xF4107CA0]
CallID=1
Port=3/0/0 (1)
BearerChannel=3/0/0.1
TxDuration=2840 ms
VoiceTxDuration=0 ms
FaxTxDuration=0 ms
FaxRate=disable bps
FaxRelayMaxJitBufDepth 346
FaxRelayJitterBufOverflow 0
Initial HS Modulation is V.17/long/14400
Recent HS modulation is V.17/short/14400
Number of pages 1
Direction of transmission is Transmit
Num of Packets TX'ed/RX'ed 932/52
Packet loss conceal is 0
Encapsulation protocol is T.38 (UDPTL)
ECM is DISABLED
NoiseLevel=0
ACOMLevel=0
OutSignalLevel=0
InSignalLevel=0
InfoActivity=0
ERLLevel=0
SessionTarget=
ImgPages=0
CallerName=
CallerIDBlocked=False
OriginalCallingNumber=5551234
OriginalCallingOctet=0x80
OriginalCalledNumber=5555678
OriginalCalledOctet=0x80
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=5551234
TranslatedCallingOctet=0x80
TranslatedCalledNumber=5555678
TranslatedCalledOctet=0x80
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=5555678
GwReceivedCalledOctet3=0x80
GwReceivedCallingNumber=5551234
GwReceivedCallingOctet3=0x80
GwReceivedCallingOctet3a=0x0
DSPIdentifier=1/0:0
Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 0
MGCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 1

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
SPRTInfoFramesReceived=0
SPRTInfoTFramesSent=0
SPRTInfoTFramesResent=0
SPRTXidFramesReceived=0
SPRTXidFramesSent=0
SPRTTotalInfoBytesReceived=0
SPRTTotalInfoBytesSent=0
SPRTPacketDrops=0

The following is sample output from the show call active voice command:

Router# show call active voice 

Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 1
Call agent controlled call-legs: 0
SCCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 2

 GENERIC:
SetupTime=1072620 ms
Index=1
PeerAddress=9193927582
PeerSubAddress=
PeerId=8
PeerIfIndex=19
LogicalIfIndex=0
ConnectTime=1078940 ms
CallDuration=00:00:51 sec
CallState=4
CallOrigin=2
ChargedUnits=0
InfoType=speech
TransmitPackets=1490
TransmitBytes=0
ReceivePackets=2839
ReceiveBytes=56780
VOIP:
ConnectionId[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
IncomingConnectionId[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
CallID=1
RemoteIPAddress=10.44.44.44
RemoteUDPPort=17096
RemoteSignallingIPAddress=10.44.44.44
RemoteSignallingPort=56434
RemoteMediaIPAddress=10.44.44.44
RemoteMediaPort=17096
RoundTripDelay=6 ms
SelectedQoS=best-effort
tx_DtmfRelay=h245-signal
FastConnect=TRUE

AnnexE=FALSE

Separate H245 Connection=FALSE

H245 Tunneling=TRUE

SessionProtocol=cisco
ProtocolCallId=
SessionTarget=
OnTimeRvPlayout=54160
GapFillWithSilence=0 ms
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=70 ms
LoWaterPlayoutDelay=60 ms
TxPakNumber=1490 
TxSignalPak=0 
TxComfortNoisePak=1 
TxDuration=54240 
TxVoiceDuration=29790 
RxPakNumber=2711 
RxSignalPak=0 
RxDuration=0 
TxVoiceDuration=54210 
VoiceRxDuration=54160 
RxOutOfSeq=0 
RxLatePak=0 
RxEarlyPak=0 
PlayDelayCurrent=60 
PlayDelayMin=60 
PlayDelayMax=70 
PlayDelayClockOffset=212491899 
PlayDelayJitter=0 ms
PlayErrPredictive=0 
PlayErrInterpolative=0 
PlayErrSilence=0 
PlayErrBufferOverFlow=10 
PlayErrRetroactive=0 
PlayErrTalkspurt=0 
OutSignalLevel=-57 
InSignalLevel=-51 
LevelTxPowerMean=0 
LevelRxPowerMean=-510 
LevelBgNoise=0 
ERLLevel=16 
ACOMLevel=16 
ErrRxDrop=0 
ErrTxDrop=0 
ErrTxControl=0 
ErrRxControl=0 
ReceiveDelay=60 ms
LostPackets=0
EarlyPackets=0
LatePackets=0
SRTP = off
VAD = enabled
CoderTypeRate=g729r8
CodecBytes=20
Media Setting=flow-through
CallerName=
CallerIDBlocked=False
OriginalCallingNumber=9193927582
OriginalCallingOctet=0x21
OriginalCalledNumber=93615494
OriginalCalledOctet=0xC1
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0xFF
TranslatedCallingNumber=9193927582
TranslatedCallingOctet=0x21
TranslatedCalledNumber=93615494
TranslatedCalledOctet=0xC1
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0xFF
GwReceivedCalledNumber=93615494
GwReceivedCalledOctet3=0xC1
GwReceivedCallingNumber=9193927582
GwReceivedCallingOctet3=0x21
GwReceivedCallingOctet3a=0x81
MediaInactiveDetected=no
MediaInactiveTimestamp=
MediaControlReceived=
Username=

 GENERIC:
SetupTime=1072760 ms
Index=1
PeerAddress=93615494
PeerSubAddress=
PeerId=9
PeerIfIndex=18
LogicalIfIndex=4
ConnectTime=1078940 ms
CallDuration=00:00:53 sec
CallState=4
CallOrigin=1
ChargedUnits=0
InfoType=speech
TransmitPackets=2953
TransmitBytes=82684
ReceivePackets=1490
ReceiveBytes=29781
TELE:
ConnectionId=[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
IncomingConnectionId=[0xE28B6D1D 0x3D9011D6 0x800400D0 0xBA0D97A1]
CallID=2
Port=3/0/0 (1)
BearerChannel=3/0/0.2
TxDuration=59080 ms
VoiceTxDuration=29790 ms
FaxTxDuration=0 ms
CoderTypeRate=g729r8
NoiseLevel=-54
ACOMLevel=16
OutSignalLevel=-57
InSignalLevel=-51
InfoActivity=1
ERLLevel=16
EchoCancellerMaxReflector=8
SessionTarget=
ImgPages=0
CallerName=
CallerIDBlocked=False
AlertTimepoint=1073340 ms
OriginalCallingNumber=9193927582
OriginalCallingOctet=0x21
OriginalCalledNumber=93615494
OriginalCalledOctet=0xC1
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
DSPIdentifier=3/1:1
Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 1
Call agent controlled call-legs: 0
SCCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 2

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

Telephony call-legs: 2
SIP call-legs: 0
H323 call-legs: 0
Call agent controlled call-legs: 2
SCCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 4

 GENERIC:
SetupTime=1557650 ms
Index=1
PeerAddress=
PeerSubAddress=
PeerId=999100
PeerIfIndex=14
LogicalIfIndex=10
ConnectTime=1562040 ms
CallDuration=00:01:01 sec
CallState=4
CallOrigin=2
ChargedUnits=0
InfoType=speech
TransmitPackets=3101
TransmitBytes=519564
ReceivePackets=3094
ReceiveBytes=494572
TELE:
ConnectionId=[0x11B1860C 0x22D711D7 0x8014E4D4 0x8FD15327]
IncomingConnectionId=[0x11B1860C 0x22D711D7 0x8014E4D4 0x8FD15327]
CallID=25
Port=3/0/0 (25)
BearerChannel=3/0/0.1
TxDuration=59670 ms
VoiceTxDuration=59670 ms
FaxTxDuration=0 ms
CoderTypeRate=g711ulaw
NoiseLevel=-12
ACOMLevel=22
OutSignalLevel=-12
InSignalLevel=-11
InfoActivity=1
ERLLevel=22
EchoCancellerMaxReflector=2
SessionTarget=
ImgPages=0
CallerName=
CallerIDBlocked=False
OriginalCallingNumber=
OriginalCallingOctet=0x0
OriginalCalledNumber=
OriginalCalledOctet=0x80
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingNumber=
TranslatedCallingOctet=0x0
TranslatedCalledNumber=
TranslatedCalledOctet=0x80
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
DSPIdentifier=1/1:1

 GENERIC:
SetupTime=1559430 ms
Index=1
PeerAddress=7702
PeerSubAddress=
PeerId=999100
PeerIfIndex=14
LogicalIfIndex=11
ConnectTime=1562020 ms
CallDuration=00:01:03 sec
CallState=4
CallOrigin=1
ChargedUnits=0
InfoType=speech
TransmitPackets=3151
TransmitBytes=528900
ReceivePackets=3158
ReceiveBytes=503876
TELE:
ConnectionId=[0x0 0x0 0x0 0x0]
IncomingConnectionId=[0x0 0x0 0x0 0x0]
CallID=26
Port=3/0/0 (26)
BearerChannel=3/0/0.2
TxDuration=60815 ms
VoiceTxDuration=60815 ms
FaxTxDuration=0 ms
CoderTypeRate=g711ulaw
NoiseLevel=-12
ACOMLevel=28
OutSignalLevel=-12
InSignalLevel=-11
InfoActivity=1
ERLLevel=28
EchoCancellerMaxReflector=2
SessionTarget=
ImgPages=0
CallerName=
CallerIDBlocked=False
AlertTimepoint=1559430 ms
OriginalCallingNumber=
OriginalCallingOctet=0x0
OriginalCalledNumber=
OriginalCalledOctet=0x0
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingNumber=7701
TranslatedCallingOctet=0x0
TranslatedCalledNumber=7702
TranslatedCalledOctet=0x0
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
GwOutpulsedCalledNumber=7702
GwOutpulsedCalledOctet3=0x0
GwOutpulsedCallingNumber=7701
GwOutpulsedCallingOctet3=0x0
GwOutpulsedCallingOctet3a=0x0
DSPIdentifier=1/1:2

 GENERIC:
SetupTime=1562040 ms
Index=1
PeerAddress=
PeerSubAddress=
PeerId=0
PeerIfIndex=0
LogicalIfIndex=0
ConnectTime=0 ms
CallDuration=00:00:00 sec
CallState=2
CallOrigin=1
ChargedUnits=0
InfoType=speech
TransmitPackets=3215
TransmitBytes=512996
ReceivePackets=3208
ReceiveBytes=512812
VOIP:
ConnectionId[0x0 0x0 0x0 0x0]
IncomingConnectionId[0x0 0x0 0x0 0x0]
CallID=27
RemoteIPAddress=10.10.0.0
RemoteUDPPort=17718
RemoteSignallingIPAddress=10.10.0.0
RemoteSignallingPort=0
RemoteMediaIPAddress=10.2.6.10
RemoteMediaPort=17718
RoundTripDelay=0 ms
SelectedQoS=best-effort
tx_DtmfRelay=inband-voice
FastConnect=FALSE

AnnexE=FALSE

Separate H245 Connection=FALSE

H245 Tunneling=FALSE

SessionProtocol=other
ProtocolCallId=
SessionTarget=
OnTimeRvPlayout=60640
GapFillWithSilence=0 ms
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=105 ms
LoWaterPlayoutDelay=105 ms
TxPakNumber=3040 
TxSignalPak=0 
TxComfortNoisePak=0 
TxDuration=60815 
TxVoiceDuration=60815 
RxPakNumber=3035 
RxSignalPak=0 
RxDuration=0 
TxVoiceDuration=60690 
VoiceRxDuration=60640 
RxOutOfSeq=0 
RxLatePak=0 
RxEarlyPak=0 
PlayDelayCurrent=105 
PlayDelayMin=105 
PlayDelayMax=105 
PlayDelayClockOffset=-1662143961 
PlayDelayJitter=0 
PlayErrPredictive=0 
PlayErrInterpolative=0 
PlayErrSilence=0 
PlayErrBufferOverFlow=0 
PlayErrRetroactive=0 
PlayErrTalkspurt=0 
OutSignalLevel=-12 
InSignalLevel=-11 
LevelTxPowerMean=0 
LevelRxPowerMean=-115 
LevelBgNoise=0 
ERLLevel=28 
ACOMLevel=28 
ErrRxDrop=0 
ErrTxDrop=0 
ErrTxControl=0 
ErrRxControl=0 
PlayoutMode = undefined
PlayoutInitialDelay=0 ms
ReceiveDelay=105 ms
LostPackets=0
EarlyPackets=0
LatePackets=0
SRTP = off
VAD = disabled
CoderTypeRate=g711ulaw
CodecBytes=160
Media Setting=flow-around

Modem passthrough signaling method is nse:
Buffer Fill Events = 0
Buffer Drain Events = 0
Percent Packet Loss = 0
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

CallerName=
CallerIDBlocked=False
OriginalCallingNumber=
OriginalCallingOctet=0x0
OriginalCalledNumber=
OriginalCalledOctet=0x0
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingNumber=
TranslatedCallingOctet=0x0
TranslatedCalledNumber=
TranslatedCalledOctet=0x0
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
MediaInactiveDetected=no
MediaInactiveTimestamp=
MediaControlReceived=
Username=

 GENERIC:
SetupTime=1562040 ms
Index=2
PeerAddress=
PeerSubAddress=
PeerId=0
PeerIfIndex=0
LogicalIfIndex=0
ConnectTime=0 ms
CallDuration=00:00:00 sec
CallState=2
CallOrigin=1
ChargedUnits=0
InfoType=speech
TransmitPackets=3380
TransmitBytes=540332
ReceivePackets=3386
ReceiveBytes=540356
VOIP:
ConnectionId[0x0 0x0 0x0 0x0]
IncomingConnectionId[0x0 0x0 0x0 0x0]
CallID=28
RemoteIPAddress=10.0.0.0
RemoteUDPPort=18630
RemoteSignallingIPAddress=10.10.0.0
RemoteSignallingPort=0
RemoteMediaIPAddress=10.2.6.10
RemoteMediaPort=18630
RoundTripDelay=0 ms
SelectedQoS=best-effort
tx_DtmfRelay=inband-voice
FastConnect=FALSE

AnnexE=FALSE

Separate H245 Connection=FALSE

H245 Tunneling=FALSE

SessionProtocol=other
ProtocolCallId=
SessionTarget=
OnTimeRvPlayout=63120
GapFillWithSilence=0 ms
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=105 ms
LoWaterPlayoutDelay=105 ms
TxPakNumber=3158 
TxSignalPak=0 
TxComfortNoisePak=0 
TxDuration=63165 
TxVoiceDuration=63165 
RxPakNumber=3164 
RxSignalPak=0 
RxDuration=0 
TxVoiceDuration=63165 
VoiceRxDuration=63120 
RxOutOfSeq=0 
RxLatePak=0 
RxEarlyPak=0 
PlayDelayCurrent=105 
PlayDelayMin=105 
PlayDelayMax=105 
PlayDelayClockOffset=957554296 
PlayDelayJitter=0 
PlayErrPredictive=0 
PlayErrInterpolative=0 
PlayErrSilence=0 
PlayErrBufferOverFlow=0 
PlayErrRetroactive=0 
PlayErrTalkspurt=0 
OutSignalLevel=-12 
InSignalLevel=-11 
LevelTxPowerMean=0 
LevelRxPowerMean=-114 
LevelBgNoise=0 
ERLLevel=22 
ACOMLevel=22 
ErrRxDrop=0 
ErrTxDrop=0 
ErrTxControl=0 
ErrRxControl=0 
PlayoutMode = undefined
PlayoutInitialDelay=0 ms
ReceiveDelay=105 ms
LostPackets=0
EarlyPackets=0
LatePackets=0
SRTP = off
VAD = disabled
CoderTypeRate=g711ulaw
CodecBytes=160
Media Setting=flow-around

Modem passthrough signaling method is nse:
Buffer Fill Events = 0
Buffer Drain Events = 0
Percent Packet Loss = 0
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

CallerName=
CallerIDBlocked=False
OriginalCallingNumber=
OriginalCallingOctet=0x0
OriginalCalledNumber=
OriginalCalledOctet=0x0
OriginalRedirectCalledNumber=
OriginalRedirectCalledOctet=0x0
TranslatedCallingNumber=
TranslatedCallingOctet=0x0
TranslatedCalledNumber=
TranslatedCalledOctet=0x0
TranslatedRedirectCalledNumber=
TranslatedRedirectCalledOctet=0x0
MediaInactiveDetected=no
MediaInactiveTimestamp=
MediaControlReceived=
Username=
Telephony call-legs: 2
SIP call-legs: 0
H323 call-legs: 0
Call agent controlled call-legs: 2
SCCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 4

The following is sample output from the show call active voice command to indicate if SAF is being used.

Router# show call active voice

Total call-legs: 2
GENERIC:
SetupTime=1971780 ms
Index=1
PeerAddress=6046692010
PeerSubAddress=
PeerId=20003
PeerIfIndex=17
...
VOIP:
SessionProtocol=sipv2
ProtocolCallId=7A9E7D9A-EAD311DC-8036BCC4-6EEE85D6@1.5.6.12
SessionTarget=1.5.6.10
SafEnabled=TRUE
SafTrunkRouteId=1
SafPluginDialpeerTag=8

The following is sample output from the show call active voice command for fax-relay traffic:

Router# show call active voice

Telephony call-legs: 0
SIP call-legs: 0
H323 call-legs: 1
MGCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 1

 GENERIC:
SetupTime=1049400 ms
Index=2
PeerAddress=52930
PeerSubAddress=
PeerId=82
PeerIfIndex=222
LogicalIfIndex=0
ConnectTime=105105
CallDuration=00:00:59
CallState=4
CallOrigin=1
ChargedUnits=0
InfoType=10
TransmitPackets=1837
TransmitBytes=29764
ReceivePackets=261
ReceiveBytes=4079
VOIP:
ConnectionId[0xEB630F4B 0x9F5E11D7 0x8008CF18 0xB9C3632]
IncomingConnectionId[0xEB630F4B 0x9F5E11D7 0x8008CF18 0xB9C3632]
RemoteIPAddress=10.7.95.3
RemoteUDPPort=16610
RemoteSignallingIPAddress=10.7.95.3
RemoteSignallingPort=1720
RemoteMediaIPAddress=10.7.95.3
RemoteMediaPort=16610
RoundTripDelay=13 ms
SelectedQoS=best-effort
tx_DtmfRelay=inband-voice
FastConnect=TRUE

AnnexE=FALSE

Separate H245 Connection=FALSE

H245 Tunneling=TRUE

SessionProtocol=cisco
ProtocolCallId=
SessionTarget=ipv4:10.7.95.3
OnTimeRvPlayout=1000
GapFillWithSilence=0 ms
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=110 ms
LoWaterPlayoutDelay=70 ms
ReceiveDelay=70 ms
LostPackets=0
EarlyPackets=1
LatePackets=0
VAD = enabled
CoderTypeRate=t38
CodecBytes=40
Media Setting=flow-through
AlertTimepoint=104972
CallerName=
CallerIDBlocked=False
OriginalCallingNumber=4085550130
OriginalCallingOctet=0x0
OriginalCalledNumber=52930
OriginalCalledOctet=0xE9
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
Username=
FaxRelayMaxJitterBufDepth  = 0 ms
FaxRelayJitterBufOverFlow = 0
FaxRelayHSmodulation = 0
FaxRelayNumberOfPages = 0
Telephony call-legs: 0
SIP call-legs: 0
H323 call-legs: 1
MGCP call-legs: 0
Multicast call-legs: 0
Total call-legs: 1


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>
<codec> (payload size)
ATM <protocol> [int vpi/vci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
<codec> (payload size)
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>

Total call-legs:2 
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 
y:69/69/70ms g729r8 
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 
i/0:-45/-45 dBm 

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

ACOM=-65  ERL=45
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
Ecan version = 8180

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 

ACOM=-15  ERL=7 
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> 
Total call-legs: 2
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

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

Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 0
MGCP call-legs: 0
Total call-legs: 1


GENERIC:
SetupTime=590180 ms
Index=2
PeerAddress=4085452930
PeerSubAddress=
PeerId=81
PeerIfIndex=221
LogicalIfIndex=145
DisconnectCause=10  
DisconnectText=normal call clearing (16)
ConnectTime=59389
DisconnectTime=68204
CallDuration=00:01:28
CallOrigin=2
ReleaseSource=1
ChargedUnits=0
InfoType=fax
TransmitPackets=295
TransmitBytes=5292
ReceivePackets=2967
ReceiveBytes=82110
TELE:
ConnectionId=[0xD9ACDFF1 0x9F5D11D7 0x8002CF18 0xB9C3632]
IncomingConnectionId=[0xD9ACDFF1 0x9F5D11D7 0x8002CF18 0xB9C3632]
CallID=2
Port=3/0/0 (2)
BearerChannel=3/0/0.1
TxDuration=28960 ms
VoiceTxDuration=0 ms
FaxTxDuration=28960 ms
FaxRate=voice bps
FaxRelayMaxJitterBufDepth  = 0 ms
FaxRelayJitterBufOverFlow = 0
FaxRelayHSmodulation = 0
FaxRelayNumberOfPages = 0
NoiseLevel=-120
ACOMLevel=127
SessionTarget=
ImgPages=0
CallerName=
CallerIDBlocked=False
OriginalCallingNumber=4085550130
OriginalCallingOctet=0x0
OriginalCalledNumber=52930
OriginalCalledOctet=0xE9
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

Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 0
MGCP call-legs: 0
Total call-legs: 1


GENERIC:
SetupTime=9872460 ms
Index=8
PeerAddress=41023
PeerSubAddress=
PeerId=1
PeerIfIndex=242
LogicalIfIndex=180
DisconnectCause=10  
DisconnectText=normal call clearing (16)
ConnectTime=9875610 ms
DisconnectTime=9936000 ms
CallDuration=00:01:00 sec
CallOrigin=2
ReleaseSource=1
ChargedUnits=0
InfoType=fax
TransmitPackets=268
TransmitBytes=4477
ReceivePackets=1650
ReceiveBytes=66882
TELE:
ConnectionId=[0xD6635DD5 0x9FA411D8 0x8005000A 0xF4107CA0]
IncomingConnectionId=[0xD6635DD5 0x9FA411D8 0x8005000A 0xF4107CA0]
CallID=7
Port=3/0/0:0 (7)
BearerChannel=3/0/0.8
TxDuration=6170 ms
VoiceTxDuration=0 ms
FaxTxDuration=0 ms
FaxRate=disable bps
FaxRelayMaxJitterBufDepth=560 ms
FaxRelayJitterBufOverFlow=0
FaxRelayMostRecentHSmodulation=V.17/short/14400
FaxRelayNumberOfPages=1
FaxRelayInitHSmodulation=V.17/long/14400
FaxRelayDirection=Transmit
FaxRelayPktLossConceal=0
FaxRelayEcmStatus=ENABLED
FaxRelayEncapProtocol=T.38 (UDPTL)
FaxRelayNsfCountryCode=Japan
FaxRelayNsfManufCode=0031B8EE80C48511DD0D0000DDDD0000DDDD000000000000000022ED00B0A400
FaxRelayFaxSuccess=Success
NoiseLevel=0
ACOMLevel=0
SessionTarget=
ImgPages=0
CallerName=Analog 41023
CallerIDBlocked=False
OriginalCallingNumber=
OriginalCallingOctet=0x80
OriginalCalledNumber=41021
OriginalCalledOctet=0xA1
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

GENERIC:
SetupTime=104648 ms
Index=1
PeerAddress=55240
PeerSubAddress=
PeerId=2
PeerIfIndex=105
LogicalIfIndex=0
DisconnectCause=10
DisconnectText=normal call clearing.
ConnectTime=104964
DisconectTime=143329
CallDuration=00:06:23
CallOrigin=1
ChargedUnits=0
InfoType=speech
TransmitPackets=37668
TransmitBytes=6157536
ReceivePackets=37717
ReceiveBytes=6158452
VOIP:
ConnectionId[0x4B091A27 0x3EDD0003 0x0 0xFEFD4]
CallID=2
RemoteIPAddress=10.14.82.14
RemoteUDPPort=18202
RoundTripDelay=2 ms
SelectedQoS=best-effort
tx_DtmfRelay=inband-voice
FastConnect=TRUE

SessionProtocol=cisco
SessionTarget=ipv4:10.14.82.14
OnTimeRvPlayout=40
GapFillWithSilence=0 ms
GapFillWithPrediction=0 ms
GapFillWithInterpolation=0 ms
GapFillWithRedundancy=0 ms
HiWaterPlayoutDelay=67 ms
LoWaterPlayoutDelay=67 ms
ReceiveDelay=67 ms
LostPackets=0 ms
EarlyPackets=0 ms
LatePackets=0 ms
VAD = enabled
CoderTypeRate=g729r8
CodecBytes=20
cvVoIPCallHistoryIcpif=0
SignalingType=cas

Modem passthrough signaling method is nse
Buffer Fill Events = 0
Buffer Drain Events = 0
Percent Packet Loss = 0
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

GENERIC:
SetupTime=104443 ms
Index=2
PeerAddress=50110
PeerSubAddress=
PeerId=100
PeerIfIndex=104
LogicalIfIndex=10
DisconnectCause=10
DisconnectText=normal call clearing.
ConnectTime=104964
DisconectTime=143330
CallDuration=00:06:23
CallOrigin=2
ChargedUnits=0
InfoType=speech
TransmitPackets=37717
TransmitBytes=5706436
ReceivePackets=37668
ReceiveBytes=6609552
TELE:
ConnectionId=[0x4B091A27 0x3EDD0003 0x0 0xFEFD4]
CallID=3
Port=3/0/0 (3)
BearerChannel=3/0/0.1
TxDuration=375300 ms
VoiceTxDuration=375300 ms
FaxTxDuration=0 ms
CoderTypeRate=g711ulaw
NoiseLevel=-75
ACOMLevel=11
SessionTarget=
ImgPages=0

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

Telephony call-legs: 1
SIP call-legs: 0
H323 call-legs: 1
Total call-legs: 2

GENERIC:
SetupTime=85975291 ms
.
.
.
DisconnectCause=10  
DisconnectText=normal call clearing (16)
ConnectTime=85975335
DisconnectTime=85979339
CallDuration=00:00:40
CallOrigin=1
ReleaseSource=1
.

.
.
DisconnectCause=10  
DisconnectText=normal call clearing (16)
ConnectTime=85975335
DisconnectTime=85979339
CallDuration=00:00:40
CallOrigin=1
ReleaseSource=1
.
.
.
VOIP:
ConnectionId[0x2868AD84 0x375B11D4 0x8012F7A5 0x74DE971E]
CallID=1
.
.
.
GENERIC:
SetupTime=85975290 ms
.
.
.
DisconnectCause=10  
DisconnectText=normal call clearing (16)
ConnectTime=85975336
DisconnectTime=85979340
CallDuration=00:00:40
CallOrigin=2
ReleaseSource=1
.
.
.
TELE:
ConnectionId=[0x2868AD84 0x375B11D4 0x8012F7A5 0x74DE971E]
CallID=2
Port=3/0/0 (2)
BearerChannel=3/0/0.1

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>
<codec> (payload size)
ATM <protocol> [int vpi/vci cid] vad:<y/n> dtmf:<y/n> seq:<y/n>
<codec> (payload size)
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
Entry address(es): 
  IP address: 10.1.17.24
  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
Holdtime : 160 sec

Version :
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:
  IP address: 10.1.17.24
  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
Entry address(es):
  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
Holdtime : 160 sec

Version :
Cisco Internetwork Operating System Software 
IOS (tm) 3600 Software (C3640-A2IS-M), Version 12.2(25)SEB4, RELE)
advertisement version: 2
Duplex Mode: half
Native VLAN: 42
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

IPv4 accounting state:
 Enabled accounting:            per-prefix, non-recursive, prefix-length
 Non-recursive load interval:   30 (default 30)
 Non-recursive update interval: 0 (default 0)

IPv6 accounting state:
 Enabled accounting:            None
 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:

Router# show cef fib 

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)
0 identical modifies

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:

Router# show cef path

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:

Router# show cef walks     

Calling process:
----------------

Number of initial walks:

                        started              
mode / priority             low          high     very high
sync                          3             0             0
atomic                        0             0             0

                       finished              
mode / priority             low          high     very high
sync                          3             0             0
atomic                        0             0             0

                      restarted              
mode / priority             low          high     very high
sync                          0             0             0
atomic                        0             0             0

Number of sub walks:

                        started              
mode / priority             low          high     very high
sync                          0             0             0
atomic                        0             0             0

                       finished              
mode / priority             low          high     very high
sync                          0             0             0
atomic                        0             0             0

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