# Monitoring Active IPv6 Multicast Routes

#### Purpose

Display the active multicast routes.

- You can specify a multicast group IPv6 address or both a multicast group IPv6 address and a multicast source IPv6 address to display information about particular multicast forwarding entries.
- You can specify the bandwidth threshold to display the active multicast routes with admission bandwidth greater than the specified bandwidth threshold. The default bandwidth threshold is 4000 bps.
- You can use the summary option to see a summary rather than a detailed description.
- You can use the count option to display the number of active multicast forwarding entries.
- You can use the oif-detail option to display the details of the join interfaces corresponding to the mapped interface when oif-mapping is configured.
- You can use the statistics option to display statistics for packets received through all active multicast forwarding entries that the router has added to the multicast routing table and established on the appropriate line modules.

#### Action

To display the active multicast routes with admission bandwidth above 10000 bps:

    host1#show ipv6 mroute active 10000
    Active IP Multicast Routes >=10000 bps

    (S, G) uptime d h:m:s[, expires d h:m:s]

    [Admission bandwidth: bps]

    [QoS bandwidth: bps]

    RPF route: addr/mask, incoming interface

    neighbor address, owner route-owner

    Incoming interface list:

    Interface (addr/mask), State/Owner [(RPF IIF)]

    Outgoing interface list:

    Interface (addr/mask), State/Owner, Uptime/Expires

    (52::1, ff3e::1) uptime 0 00:01:07

    Admission bandwidth: 47000 bps (adaptive)

    QoS bandwidth: 47000 bps (adaptive)

    RPF route: 52::/112, incoming interface ATM2/1.17

    neighbor 17::2, owner NetmgmtRpf

    Incoming interface list:

    ATM2/1.17 (fe80::90:1a00:3140:1ff8/128), Accept/MLD (RPF IIF)

    Outgoing interface list:

    NULL

    Counts: 1 (S, G) entries

    0 (*, G) entries

To display the summary of active multicast routes:

    host1#show ipv6 mroute summary active
    Active IP Multicast Routes >=4000 bps

    Group Address Source Address  RPF route RPF Iif   #Oifs

    --------------- ------------ ----------- --------- -----

    232.0.0.1     51.0.0.1      51.0.0.0/24  ATM3/1.17  0

    232.0.0.2     51.0.0.1      51.0.0.0/24  ATM3/1.17  0

    232.0.0.3     51.0.0.1      51.0.0.0/24  ATM3/1.17  0

    Counts: 3 (S, G) entries

    0 (*, G) entries

#### Meaning

Table 16 lists the show ipv6 mroute active and show ipv6 mroute summary active commands output fields.

Table 16: show ipv6 mroute active and show ipv6 mroute summary active Output Fields

Field Name | Field Description
--- | ---
(S,G) | IPv6 addresses of the multicast source and the multicast group
Uptime | Length of time that the (S,G) pair has been active, in days hours:minutes:seconds format
Expires | Length of time for which the (S,G) pair will be active, in days hours:minutes:seconds format
Admission bandwidth | Admission bandwidth (in bps)
QoS bandwidth | QoS bandwidth (in bps)
RPF Route | IPv6 address and prefix of the RPF route
Incoming interface | Type and specifier of the incoming interface for the RPF route
neighbor address | IPv6 address of the neighbor
owner | Owner of the route: Local—route belonging to the local interface Static—Static route Other protocols—Route established by a protocol
Incoming interface list | List of incoming interfaces on the router. Details include: Type of interface and its specifier Action that the interface takes with packets: accept or discard Multicast protocol that owns the interface Time that the interface has been active in this multicast forwarding entry, in days hours:minutes:seconds format Time that the interface will cease to be active in this multicast forwarding entry, in days hours:minutes:seconds format
Outgoing interface list | List of outgoing interfaces on the router. Details include: Type of interface and its specifier Action that the interface takes with packets: Forward or Blocked (intf-adm-limit, join-intf-adm-limit, port-adm-limit, port-limit, port-priority-limit) Protocol running on the interface: PIM or MLD Time that the interface has been active in this multicast forwarding entry, in days hours:minutes:seconds format Time that the interface will cease to be active in this multicast forwarding entry, in days hours:minutes:seconds format
Counts | Numbers of types of source group mappings: (S,G)—Number of (S,G) entries (*,G)—Number of (*,G) entries
Group Address | IP address of the multicast group
Source Address | IP address of the multicast source
RPF Iif | Type and identifier for the incoming interface for the RPF route
#Oifs | Number of outgoing interfaces

#### Related Documentation

- Defining IPv6 Static Routes for Reverse-Path Forwarding
- Example: Configuring an IPv6 Multicast Bandwidth Map
- Activating IPv6 Multicast QoS Adjustment Functions
- Blocking IPv6 Mroutes
- Enabling Interface-Level Admission Bandwidth Limitation for IPv6
- Creating IPv6 Mroute Port Limits
- Enabling Port-Level Admission Bandwidth Limitation for IPv6
- show ipv6 mroute