3.15. IP Multicast Command Reference

3.15.1. Command Hierarchies

  1. Tools Commands (refer to the Tools chapter in the 7705 SAR OAM and Diagnostics Guide)

3.15.1.1. Configuration Commands

3.15.1.1.1. IGMP Commands

configure
— router
[no] igmp
[no] interface ip-int-name
import policy-name
— no import
max-groups value
— no max-groups
max-grp-sources value
[no] shutdown
[no] grp-range start end
[no] source ip-address
static
[no] group grp-ip-address
[no] source ip-address
[no] subnet-check
version version
— no version
query-interval seconds
robust-count robust-count
— no robust-count
[no] shutdown
[no] grp-range start end
[no] source ip-address

3.15.1.1.2. MLD Commands

configure
— router
[no] mld
[no] interface ip-int-name
import policy-name
— no import
max-groups value
— no max-groups
query-interval seconds
[no] shutdown
[no] grp-range start end
[no] source ipv6-address
static
[no] group grp-ipv6-address
[no] source src-ipv6-address
version version
— no version
query-interval seconds
robust-count seconds
— no robust-count
[no] shutdown
[no] grp-range start end
[no] source src-ipv6-address

3.15.1.1.3. PIM Commands

configure
— router
[no] pim
apply-to {ies | non-ies | all | none}
import {join-policy | register-policy} policy-name[.. policy-name (up to 5 max)]
— no import {join-policy | register-policy}
[no] interface ip-int-name
assert-period assert-period
[no] bfd-enable [ipv4 | ipv6]
hello-interval hello-interval
hello-multiplier deci-units
max-groups value
— no max-groups
multicast-senders {auto | always | never}
priority dr-priority
— no priority
[no] shutdown
sticky-dr [priority dr-priority]
— no sticky-dr
[no] three-way-hello
rp
[no] anycast rp-ip-address
[no] rp-set-peer ip-address
bootstrap-export policy-name[...policy-name (up to 5 max)]
bootstrap-import policy-name[...policy-name (up to 5 max)]
address ipv4-address
— no address
hash-mask-len hash-mask-length
priority bootstrap-priority
— no priority
[no] shutdown
address ip-address
— no address
[no] group-range {grp-ip-address/mask | grp-ip-address netmask}
holdtime holdtime
— no holdtime
priority priority
— no priority
[no] shutdown
static
[no] address ip-address
[no] group-prefix {grp-ip-address/mask | grp-ip-address netmask}
[no] override
rpf-table {rtable-m | rtable-u | both}
— no rpf-table
rpf6-table {rtable6-m | rtable6-u | both}
— no rpf6-table
[no] shutdown
spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask | grp-ipv6-prefix/ipv6-prefix-length} spt-threshold
— no spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask | grp-ipv6-prefix/ipv6-prefix-length}
[no] ssm-groups
[no] group-range {ip-prefix/mask | ip-prefix netmask}

3.15.1.1.4. MSDP Commands

config
— router
[no] msdp
[no] active-source-limit number
export policy-name [policy-name...(up to 5 max)]
— no export
[no] group group-name
export policy-name [policy-name...(up to 5 max)]
— no export
import policy-name [policy-name...(up to 5 max)]
— no import
local-address address
mode {mesh-group | standard}
[no] peer peer-address
authentication-key [authentication-key | hash-key] [hash | hash2]
[no] default-peer
export policy-name [policy-name...(up to 5 max)]
— no export
import policy-name [policy-name...(up to 5 max)]
— no import
local-address address
receive-msdp-msg-rate number interval seconds [threshold number]
[no] shutdown
receive-msdp-msg-rate number interval seconds [threshold number]
[no] shutdown
import policy-name [policy-name...(up to 5 max)]
— no import
local-address address
[no] peer peer-address
authentication-key [authentication-key | hash-key] [hash | hash2]
[no] default-peer
export policy-name [policy-name...(up to 5 max)]
— no export
import policy-name [policy-name...(up to 5 max)]
— no import
local-address address
receive-msdp-msg-rate number interval seconds [threshold number]
[no] shutdown
receive-msdp-msg-rate number interval seconds [threshold number]
rpf-table {rtable-m | rtable-u | both}
— no rpf-table
sa-timeout seconds
— no sa-timeout
[no] shutdown
[no] source prefix/mask

3.15.1.2. Show Commands

show
— router
igmp
group [grp-ip-address]
group summary
interface [ip-int-name | ip-address] [group] [grp-ip-address] [detail]
ssm-translate [interface-name]
static [ip-int-name | ip-address]
statistics [ip-int-name | ip-address]
status
show
— router
mld
group [grp-ipv6-address]
interface [ip-int-name | ip-address] [group] [grp-ipv6-address] [detail]
ssm-translate [ip-int-name]
static [ip-int-name | ip-address]
statistics [ip-int-name | ipv6-address]
status
show
— router
pim
group [grp-ip-address] [source ip-address] [detail] [family]
interface [ip-int-name | ip-address] [group grp-ip-address] [source ip-address] [detail] [family]
neighbor [ip-int-name | ip-address [address neighbor-ip-address]] [detail] [family]
rp [family | ip-address]
rp-hash [family | ip-address]
s-pmsi [family | ip-address]
statistics [ip-int-name | ip-address] [family]
status [detail] [family]
show
— router
msdp
group [group-name] [detail]
peer [ip-address] [group group-name] [detail]
source [ip-address/mask] [type {configured | dynamic | both}] [detail]
source-active [{group ip-address | local | originator ip-address | peer ip-address | source ip-address | group ip-address source ip-address}] [detail]
source-active-rejected [peer-group name] [group ip-address] [source ip-address] [originator ip-address] [peer ip-address]
statistics [peer ip-address]
status

3.15.1.3. Clear Commands

clear
— router
igmp
database [interface ip-int-name | ip-address] [group grp-ip-address [source src-ip-address]]
statistics [ip-int-name | ip-address]
version [ip-int-name | ip-address]
clear
— router
mld
database [interface ip-int-name | ipv6-address] [group grp-ipv6-address [source src-ipv6-address]]
statistics [ip-int-name | ipv6-address]
version [ip-int-name | ip-address]
clear
— router
pim
database [interface ip-int-name | ip-address] [group grp-ip-address [source ip-address]] [family]
neighbor [ip-int-name] [family]
statistics [family]
statistics interface ip-int-name | ip-address [family]
statistics group grp-ip-address [source ip-address] [family]
clear
— router
msdp
cache [peer ip-address] [group ip-address] [source ip-address] [originrp ip-address]
statistics [peer ip-address]

3.15.1.4. Debug Commands

debug
— router
[no] igmp
[no] interface [ip-int-name | ip-address]
[no] misc
packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address]
— no packet
debug
— router
[no] mld
[no] interface [ip-int-name | ipv6-address]
[no] misc
packet [query | v1-report | v2-report | v1-done] [ip-int-name | ipv6-address]
— no packet
debug
— router
[no] pim
[no] adjacency
all [group grp-ip-address] [source ip-address] [detail]
— no all
assert [group grp-ip-address] [source ip-address] [detail]
— no assert
auto-rp [detail]
— no auto-rp
bgp [group grp-ip-address] [source ip-address] [peer peer-ip-address] [detail]
— no bgp
bsr [detail]
— no bsr
data [group grp-ip-address] [source ip-address] [detail]
— no data
db [group grp-ip-address] [source ip-address] [detail]
— no db
interface [ip-int-name | ip-address] [detail]
— no interface
jp [group grp-ip-address] [source ip-address] [detail]
— no jp
mrib [group grp-ip-address] [source ip-address] [detail]
— no mrib
msg [detail]
— no msg
packet [hello | register | register-stop | jp | bsr | assert | crp] [ip-int-name | ip-address]
— no packet
[no] red [detail]
register [group grp-ip-address] [source ip-address] [detail]
— no register
rtm [detail]
— no rtm
debug
— router
[no] mtrace
[no] misc
[no] packet [query | request | response]

3.15.1.5. Monitor Commands

monitor
— router
— pim
group grp-ip-address [source ip-address] [interval interval] [repeat repeat] [absolute | rate]

3.15.2. Command Descriptions

3.15.2.1. Configuration Commands

3.15.2.1.1. Generic Commands

shutdown

Syntax 
[no] shutdown
Context 
config>router>igmp
config>router>igmp>interface
config>router>mld
config>router>mld>interface
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>pim
config>router>pim>interface
config>router>pim>rp>bsr-candidate
config>router>pim>rp>rp-candidate
Description 

This command administratively disables the entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics. Many entities must be explicitly enabled using the no shutdown command.

The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they can be deleted.

Unlike other commands and parameters where the default state is not indicated in the configuration file, shutdown and no shutdown are always indicated in system-generated configuration files.

The no form of the command puts an entity into the administratively enabled state.

Default 

no shutdown

3.15.2.1.2. IGMP Commands

igmp

Syntax 
[no] igmp
Context 
config>router
Description 

This command enables the Internet Group Management Protocol (IGMP) context. When the context is created, the IGMP protocol is enabled.

The Internet Group Management Protocol (IGMP) is used by IPv4 systems (hosts and routers) to report their IP multicast group memberships to neighboring multicast routers. An IP multicast router can be a member of one or more multicast groups, in which case it performs both the “multicast router” part of the protocol, which collects the membership information needed by its multicast routing protocol, and the “group member” part of the protocol, which informs itself and other neighboring multicast routers of its memberships.

The no form of the command disables the IGMP instance. To start or suspend execution of IGMP without affecting the configuration, use the no shutdown command.

Default 

n/a

interface

Syntax 
[no] interface ip-int-name
Context 
config>router>igmp
Description 

This command enables the context to configure an IGMP interface. The interface is a local identifier of the network interface on which reception of the specified multicast address is to be enabled or disabled.

The no form of the command deletes the IGMP interface. The shutdown command in the config>router>igmp>interface context can be used to disable an interface without removing the configuration for the interface.

Default 

no interface (no interfaces are defined)

Parameters 
ip-int-name—
the IP interface name. Interface names must be unique within the group of defined IP interfaces for config>router>igmp>interface and config>service>ies>interface commands. An interface name cannot be in the form of an IP address. Interface names can be any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

If the IP interface name does not exist or does not have an IP address configured, an error message will be returned.

disable-router-alert-check

Syntax 
[no] disable-router-alert-check
Context 
config>router>igmp>interface
Description 

This command disables or enables router alert checking for IGMP messages received on the interface.

The no form of the command enables the IGMP router alert check option.

Default 

no disable-router-alert-check

import

Syntax 
import policy-name
no import
Context 
config>router>igmp>interface
Description 

This command specifies the import route policy to be used for determining which membership reports are accepted by the router. Route policies are configured in the config>router>policy-options context (see the “Route Policies” section in the 7705 SAR Router Configuration Guide).

If an import policy is not specified, all the IGMP reports are accepted.

The no form of the command removes the policy association from the IGMP instance.

Default 

no import (no import policy specified)

Parameters 
policy-name—
the route policy name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

max-groups

Syntax 
max-groups value
no max-groups
Context 
config>router>igmp>interface
Description 

This command specifies the maximum number of groups for which IGMP can have local receiver information based on received IGMP reports on this interface. If this configuration is changed dynamically to a value lower than the currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups will not be allowed.

The no version of the command removes the configured value and the maximum number of groups is not defined.

Default 

no max-groups

Parameters 
value—
the maximum number of groups for the interface
Values—
1 to 256

 

max-grp-sources

Syntax 
max-grp-sources value
no max-grp-sources
Context 
config>router>igmp>interface
Description 

This command specifies the maximum number of group sources for which IGMP can have local receiver information based on received IGMP reports on this interface. If this configuration is changed dynamically to a value lower than the currently accepted number of group sources, the group sources that are already accepted are not deleted. Only new group sources will not be allowed.

The no version of the command removes the configured value and the maximum number of group sources is not defined.

Default 

no max-grp-sources

Parameters 
value—
the maximum number of group sources for the group interface
Values—
1 to 256

 

ssm-translate

Syntax 
ssm-translate
Context 
config>router>igmp
config>router>igmp>interface
Description 

This command enables the context to configure group ranges that are translated to SSM (S,G) entries. If the static entry needs to be created, it has to be translated from an IGMPv1 or IGMPv2 request to a Source-Specific Multicast (SSM) join message.

grp-range

Syntax 
[no] grp-range start end
Context 
config>router>igmp>ssm-translate
config>router>igmp>if>ssm-translate
Description 

This command adds or removes SSM translate group range entries. The group range is not created until the grp-range>source command is used to configure the source address.

Default 

n/a

Parameters 
start—
an IP address that specifies the start of the group range
Values—
a.b.c.d

 

end—
an IP address that specifies the end of the group range. This value should always be greater than or equal to the start value.
Values—
a.b.c.d

 

source

Syntax 
[no] source ip-address
Context 
config>router>igmp>ssm-translate>grp-range
config>router>igmp>if>ssm-translate>grp-range
Description 

This command specifies the source IP address for the group range. Whenever a (*,G) report is received in the range specified by the grp-range start and end parameters, it is translated to an (S,G) report with the value of this object as the source address.

Default 

n/a

Parameters 
ip-address—
the unicast IP source address
Values—
a.b.c.d

 

static

Syntax 
static
Context 
config>router>igmp>interface
Description 

This command allows multicast forwarding out an interface without having received a dynamic join report on that interface. The specific multicast traffic to be forwarded is configured using the static>group and static>group>source commands.

Default 

n/a

group

Syntax 
[no] group grp-ip-address
Context 
config>router>igmp>if>static
Description 

This command adds a static multicast (S,G) group membership to an IPv4 interface. When IGMP static groups are enabled, data is forwarded to an interface without receiving membership reports from host members. A possible use for IGMP static groups is to test multicast forwarding in the absence of an IGMP host receiver.

The group command, in combination with the source command, is used to create a specific (S,G) static group entry.

Default 

n/a

Parameters 
grp-ip-address—
specifies an IGMP multicast group address that receives data on an interface. The IP address must be unique for each static group.
Values—
a.b.c.d

 

source

Syntax 
[no] source ip-address
Context 
config>router>igmp>if>static>group
Description 

This command specifies the source IPv4 address (S) for the static IGMP group being configured. Multicast traffic to the group (G) will be forwarded out the interface on which this static group is configured if the source address in the IPv4 header of the multicast packets matches S.

The source command, in combination with the group command, is used to create a specific (S,G) static group entry.

The no form of the command removes the source from the configuration.

Default 

n/a

Parameters 
ip-address—
the IPv4 unicast address
Values—
a.b.c.d

 

subnet-check

Syntax 
[no] subnet-check
Context 
config>router>igmp>interface
Description 

This command enables subnet checking for IGMP messages received on this interface. All IGMP packets with a source address that is not in the local subnet are dropped.

Default 

enabled

version

Syntax 
version version
no version
Context 
config>router>igmp>interface
Description 

This command specifies the IGMP version. If routers run different versions of IGMP, they will negotiate the lowest common version of IGMP that is supported by hosts on their subnet and operate in that version. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.

For IGMPv3, a multicast router that is also a group member performs both parts of IGMPv3, receiving and responding to its own IGMP message transmissions as well as those of its neighbors.

Default 

3

Parameters 
version—
the IGMP version number
Values—
1, 2, or 3

 

query-interval

Syntax 
query-interval seconds
no query-interval
Context 
config>router>igmp
Description 

This command specifies the frequency at which the querying router transmits general host-query messages. Host-query messages solicit group membership information and are sent to the all-systems multicast group address, 224.0.0.1.

Default 

125

Parameters 
seconds—
the frequency, in seconds, at which the router transmits general host-query messages
Values—
2 to 1024

 

query-last-member-interval

Syntax 
query-last-member-interval seconds
no query-last-member-interval
Context 
config>router>igmp
Description 

This command configures the frequency at which the querying router sends group-specific query messages, including messages sent in response to leave-group messages. The shorter the interval, the faster the detection of the loss of the last member of a group.

Default 

1

Parameters 
seconds—
the frequency, in seconds, at which query messages are sent
Values—
1 to 1023

 

query-response-interval

Syntax 
query-response-interval seconds
no query-response-interval
Context 
config>router>igmp
Description 

This command specifies how long the querying router waits to receive a response to a host-query message from a host.

Default 

10

Parameters 
seconds—
the length of time to wait to receive a response to the host-query message from the host
Values—
1 to 1023

 

robust-count

Syntax 
robust-count robust-count
no robust-count
Context 
config>router>igmp
Description 

This command configures the robust count, which is the number of times the router will retry a query. The robust-count variable allows tuning for the expected packet loss on a subnet. If a subnet anticipates losses, the robust-count variable can be increased.

Default 

2

Parameters 
robust-count—
the robust count value
Values—
2 to 10

 

3.15.2.1.3. MLD Commands

mld

Syntax 
[no] mld
Context 
config>router
Description 

This command enables the context to configure Multicast Listener Discovery (MLD) parameters.

The no form of the command disables MLD.

Default 

no mld

interface

Syntax 
[no] interface ip-int-name
Context 
config>router>mld
Description 

This command enables the context to configure an MLD interface. The interface is a local identifier of the network interface on which reception of the specified multicast address is to be enabled or disabled.

The no form of the command deletes the MLD interface. The shutdown command in the config>router>mld>interface context can be used to disable an interface without removing the configuration for the interface.

Default 

no interface (no interfaces are defined)

Parameters 
ip-int-name—
the IP interface name. Interface names must be unique within the group of defined IP interfaces for config>router>interface and config>service>ies>interface commands. An interface name cannot be in the form of an IP address. Interface names can be any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

If the IP interface name does not exist or does not have an IP address configured, an error message will be returned.

disable-router-alert-check

Syntax 
[no] disable-router-alert-check
Context 
config>router>mld>interface
Description 

This command enables or disables the router alert checking for MLD messages received on this interface.

The no form of the command enables the MLD router alert check option.

Default 

no disable-router-alert-check (enabled)

import

Syntax 
import policy-name
no import
Context 
config>router>mld>interface
Description 

This command specifies the import route policy to be used for determining which membership reports are accepted by the router. Route policies are configured in the config>router>policy-options context.

If an import policy is not specified, all the MLD reports are accepted.

The no form of the command removes the policy association from the MLD instance.

Default 

no import (no import policy specified)

Parameters 
policy-name—
the route policy name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

max-groups

Syntax 
max-groups value
no max-groups
Context 
config>router>mld>interface
Description 

This command specifies the maximum number of groups for which MLD can have local receiver information based on received MLD reports on this interface. If this configuration is changed dynamically to a value lower than the currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups will not be allowed.

The no version of the command removes the configured value and the maximum number of groups is not defined.

Default 

no max-groups

Parameters 
value—
the maximum number of groups for this interface
Values—
1 to 256

 

query-interval

Syntax 
query-interval seconds
no query-interval
Context 
config>router>mld
config>router>mld>interface
Description 

This command specifies the frequency at which the querying router transmits general host-query messages. Host-query messages solicit group membership information and are sent to the all-systems multicast group address, 224.0.0.1.

Default 

125

Parameters 
seconds—
the frequency, in seconds, at which the router transmits general host-query messages
Values—
2 to 1024

 

query-last-listener-interval

Syntax 
query-last-listener-interval seconds
no query-last-listener-interval
Context 
config>router>mld
config>router>mld>interface
Description 

This command configures the frequency at which the querying router sends group-specific query messages, including messages sent in response to leave-group messages. The shorter the interval, the faster the detection of the loss of the last member of a group.

Default 

1

Parameters 
seconds—
the frequency, in seconds, at which query messages are sent
Values—
1 to 1023

 

query-response-interval

Syntax 
query-response-interval seconds
no query-response-interval
Context 
config>router>mld
config>router>mld>interface
Description 

This command specifies how long the querying router waits to receive a response to a host-query message from a host.

Default 

10

Parameters 
seconds—
the length of time to wait to receive a response to the host-query message from the host
Values—
1 to 1023

 

robust-count

Syntax 
robust-count robust-count
no robust-count
Context 
config>router>mld
Description 

This command configures the robust count. The robust-count variable allows tuning for the expected packet loss on a subnet. If a subnet anticipates losses, the robust-count variable can be increased.

Default 

2

Parameters 
robust-count—
the robust count value
Values—
2 to 10

 

ssm-translate

Syntax 
ssm-translate
Context 
config>router>mld
config>router>mld>interface
Description 

This command enables the context to configure group ranges that are translated to SSM (S,G) entries. If the static entry needs to be created, it has to be translated from an MLDv1 request to a Source-Specific Multicast (SSM) join message.

grp-range

Syntax 
[no] grp-range start end
Context 
config>router>mld>ssm-translate
config>router>mld>if>ssm-translate
Description 

This command is used to configure group ranges that are translated to SSM (S,G) entries.

Default 

n/a

Parameters 
start—
specifies a valid multicast group IPv6 address that identifies the start of the group range
Values—
ipv6-address:       x:x:x:x:x:x:x:x (eight 16-bit pieces)
                             x:x:x:x:x:x:d.d.d.d
                             x: [0..FFFF]H
                             d: [0..255]D

 

end—
an IP address that specifies the end of the group range. This value should always be greater than or equal to the start value.
Values—
ipv6-address:       x:x:x:x:x:x:x:x (eight 16-bit pieces)
                             x:x:x:x:x:x:d.d.d.d
                             x: [0..FFFF]H
                             d: [0..255]D

 

source

Syntax 
[no] source src-ipv6-address
Context 
config>router>mld>ssm-translate>grp-range
config>router>mld>if>ssm-translate>grp-range
Description 

This command specifies the source IPv6 address for the group range. Whenever a (*,G) report is received in the range specified by grp-range start and end parameters, it is translated to an (S,G) report with the value of this object as the source address.

Default 

n/a

Parameters 
src-ipv6-address—
the IPv6 address that will be sending data
Values—
src-ipv6-address:      x:x:x:x:x:x:x:x (eight 16-bit pieces)
                                  x:x:x:x:x:x:d.d.d.d
                                  x: [0..FFFF]H
                                  d: [0..255]D

 

static

Syntax 
static
Context 
config>router>mld>interface
Description 

This command allows multicast forwarding out an interface without having received a dynamic join report on that interface. The specific multicast traffic to be forwarded is configured using the static>group and static>group>source commands.

Default 

n/a

group

Syntax 
[no] group grp-ipv6-address
Context 
config>router>mld>if>static
Description 

This command adds a static multicast (S,G) group membership to an IPv6 interface. When MLD static groups are enabled, data is forwarded to an interface without receiving membership reports from host members. A possible use for MLD static groups is to test multicast forwarding in the absence of an MLD host receiver.

The no form of the command removes the IPv6 address from the configuration.

Default 

n/a

Parameters 
grp-ipv6-address—
specifies an MLD multicast group address that receives data on an interface. The IP address must be unique for each static group
Values—
grp-ipv6-address:       x:x:x:x:x:x:x:x (eight 16-bit pieces)
                                    x:x:x:x:x:x:d.d.d.d
                                    x: [0..FFFF]H
                                    d: [0..255]D

 

source

Syntax 
[no] source src-ipv6-address
Context 
config>router>mld>if>static>group
Description 

This command specifies the source IPv6 address (S) for the static MLD group being configured. Multicast traffic to the group (G) will be forwarded out the interface on which this static group is configured if the source address in the IPv6 header of the multicast packets matches S.

The source command, in combination with the group command, is used to create a specific (S,G) static group entry.

The no form of the command removes the source from the configuration.

Default 

n/a

Parameters 
src-ipv6-address—
the IPv6 unicast address
Values—
src-ipv6-address:       x:x:x:x:x:x:x:x (eight 16-bit pieces)
                                   x:x:x:x:x:x:d.d.d.d
                                   x: [0..FFFF]H
                                   d: [0..255]D

 

version

Syntax 
version version
no version
Context 
config>router>mld>interface
Description 

This command specifies the MLD version. If routers run different versions of MLD, they will negotiate the lowest common version of MLD that is supported by hosts on their subnet and operate in that version. For MLD to function correctly, all routers on a LAN must be configured to run the same version of MLD on that LAN.

Default 

2

Parameters 
version—
the MLD version number
Values—
1 or 2

 

3.15.2.1.4. PIM Commands

pim

Syntax 
[no] pim
Context 
config>router
Description 

This command configures a Protocol Independent Multicast (PIM) instance.

PIM is used for multicast routing within the network. Devices in the network can receive the multicast feed requested and non-participating routers can be pruned. The 7705 SAR supports PIM Source-Specific Multicast (SSM) and PIM Sparse-Mode (SM).

The no form of the command deletes the PIM instance and removes all configuration parameters.

Default 

no pim

apply-to

Syntax 
apply-to {ies | non-ies | all | none}
Context 
config>router>pim
Description 

This command automatically creates or removes PIM interfaces. The ies, non-ies, and all options create a PIM interface with default PIM parameters when a new IP or IES interface is created manually. The none option removes any automatically created PIM interfaces that have not been modified manually in the PIM context. Existing manually created or modified PIM interfaces are not affected.

The default option for the apply-to command is none, so to activate its automatic behavior it must first be saved in the PIM configuration structure. Then, all subsequent commands either create new structures (in the case of IP or IES interface commands) or modify the default values created by the apply-to command (in the case of PIM interface commands).

For example, assume that the apply-to setting is none and that two manually created PIM interfaces already exist. If the apply-to setting is changed to ies, then the two manually created PIM interfaces remain unchanged but any newly created or modified IES interfaces will automatically create a corresponding PIM interface with default PIM values. Subsequently, if the apply-to command is changed back to none, then all PIM interfaces that were not manually created or modified are removed.

If a manually created or modified PIM interface is deleted, the interface will be recreated when (re)processing the apply-to command. If PIM is not required on a specific interface, then a config>router>pim>if>shutdown command should be executed.

Default 

none (keyword)

Parameters 
ies—
automatically creates a PIM interface for all IES interfaces in PIM
non-ies—
creates non-IES interfaces in PIM
all—
creates all IES and non-IES interfaces in PIM
none—
removes all PIM interfaces that have not been manually created or modified in the PIM context

import

Syntax 
import {join-policy | register-policy} [policy-name [.. policy-name (up to 5 max)]
no import {join-policy | register-policy}
Context 
config>router>pim
Description 

This command specifies the import route policy to be used by PIM. Route policies are configured in the config>router>policy-options context. Up to five import policy names can be specified.

If an import policy is not specified, IGP routes are accepted by default.

The no form of the command removes the policy association from the instance.

Default 

no import join-policy

no import register-policy

Parameters 
join-policy—
this keyword filters PIM join messages, which prevents unwanted multicast streams from traversing the network
register-policy—
this keyword filters PIM register messages. PIM register filters prevent register messages from being processed by the RP. This filter can only be defined on an RP. When a match is found, the RP immediately sends back a register-stop message.
policy-name—
the route policy name

interface

Syntax 
[no] interface ip-int-name
Context 
config>router>pim
Description 

This command creates a logical IP routing interface.

The no form of the command removes the IP interface and all the associated configurations.

Default 

no interfaces or names are defined within PIM

Parameters 
ip-int-name —
the name of the IP interface. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

If the ip-int-name already exists, the context is changed to maintain that IP interface. If ip-int-name does not exist, the interface is created and the context is changed to that interface for further command processing.

Values—
1 to 32 alphanumeric characters

 

assert-period

Syntax 
assert-period assert-period
no assert-period
Context 
config>router>pim>interface
Description 

This command configures the period for refreshes of PIM Assert messages on an interface.

The no form of the command removes the assert period from the configuration.

Default 

no assert-period

Parameters 
assert-period—
the period for refreshes of PIM Assert messages on an interface
Values—
1 to 300 seconds

 

bfd-enable

Syntax 
[no] bfd-enable [ipv4 | ipv6]
Context 
config>router>pim>interface
Description 

This command enables the use of IPv4 or IPv6 Bidirectional Forwarding Detection (BFD) to control the state of the associated protocol interface. By enabling BFD on a given protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for BFD are set via the BFD command under the IP interface.

The no form of this command removes BFD from the associated IGP protocol adjacency.

Default 

no bfd-enable

bsm-check-rtr-alert

Syntax 
[no] bsm-check-rtr-alert
Context 
config>router>pim>interface
Description 

This command enables the checking of the router alert option in the bootstrap messages received on this interface.

Default 

no bsm-check-rtr-alert

hello-interval

Syntax 
hello-interval hello-interval
no hello-interval
Context 
config>router>pim>interface
Description 

This command configures the time interval between PIM Hello messages transmitted on this interface.

The no form of this command reverts to the default value of the hello-interval.

Default 

30

Parameters 
hello-interval—
the hello interval in seconds. A 0 (zero) value disables the sending of Hello messages (the PIM neighbor will never time out the adjacency)
Values—
0 to 255 seconds

 

hello-multiplier

Syntax 
hello-multiplier deci-units
no hello-multiplier
Context 
config>router>pim>interface
Description 

This command configures the multiplier used to determine the hold time for a PIM neighbor on this interface.

The hello-multiplier in conjunction with the hello-interval determines the hold time for a PIM neighbor.

The multiplier value is expressed in deci-units, so that (for example) 10 deci-units represents a multiplier of 1 and 35 deci-units represents a multiplier of 3.5. For example, if the hello-interval is 1 s and the hello-multiplier is 35 deci-units, then the calculated hold time (in seconds) is:

      hold time    =  (hello-interval * hello-multiplier) / 10                         =  (1 s * 35 deci-units) / 10                         =  3.5 s   

Parameters 
deci-units—
the value, specified in multiples of 0.1, for the formula (above) used to calculate the hold time based on the hello-multiplier

This allows the PIM default timeout of 3.5 seconds to be supported.

Values—
20 to 100

 

Default—
35

instant-prune-echo

Syntax 
[no] instant-prune-echo
Context 
config>router>pim>interface
Description 

This command enables or disables instant PruneEcho for a PIM interface.

Default 

no instant-prune-echo

ipv4-multicast-disable

Syntax 
[no] ipv4-multicast-disable
Context 
config>router>pim
config>router>pim>interface
Description 

This command administratively disables or enables PIM operation for IPv4.

Default 

no ipv4-multicast-disable

ipv6-multicast-disable

Syntax 
[no] ipv6-multicast-disable
Context 
config>router>pim
config>router>pim>interface
Description 

This command administratively disables or enables PIM operation for IPv6.

Default 

no ipv6-multicast-disable

max-groups

Syntax 
max-groups value
no max-groups
Context 
config>router>pim>interface
Description 

This command specifies the maximum number of groups for which PIM can have local receiver information based on received PIM reports on this interface. If this configuration is changed dynamically to a value lower than the currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups will not be allowed. This command is applicable for IPv4 and IPv6.

The no version of the command removes the configured value and the maximum number of groups is not defined.

Default 

no max-groups

Parameters 
value—
the maximum number of groups for this interface
Values—
1 to 256

 

multicast-senders

Syntax 
multicast-senders {auto | always | never}
no multicast-senders
Context 
config>router>pim>interface
Description 

This command configures how traffic from directly attached multicast sources should be treated on broadcast interfaces. It can also be used to treat all traffic received on an interface as traffic coming from a directly attached multicast source. This is particularly useful if a multicast source is connected to a point-to-point or unnumbered interface.

Default 

auto

Parameters 
auto—
specifies that, on broadcast interfaces, the forwarding plane performs a subnet-match check on multicast packets received on the interface to determine if the packet is from a directly attached source. On unnumbered or point-to-point interfaces, all traffic is implicitly treated as coming from a remote source.
always—
treats all traffic received on the interface as coming from a directly attached multicast source
never—
specifies that, on broadcast interfaces, traffic from directly attached multicast sources will not be forwarded; however, traffic from a remote source will still be forwarded if there is a multicast state for it. On unnumbered or point-to-point interfaces, it means that all traffic received on that interface must not be forwarded.

priority

Syntax 
priority dr-priority
no priority
Context 
config>router>pim>interface
Description 

This command sets the priority value that is used to elect the designated router (DR). The DR election priority is a 32-bit unsigned number and the router with numerically largest dr-priority value is always the preferred DR.

The no form of the command restores the default values.

Default 

1

Parameters 
dr-priority—
the priority value that is used to elect the DR. The higher the value, the higher the priority.
Values—
1 to 4294967295

 

sticky-dr

Syntax 
sticky-dr [priority dr-priority]
no sticky-dr
Context 
config>router>pim>interface
Description 

This command enables sticky-dr operation on this interface. When enabled, the priority in PIM Hello messages sent on this interface when elected as the designated router (DR) will be modified to the value configured in dr-priority. This is done to avoid the delays in forwarding caused by DR recovery, when switching back to the old DR on a LAN when it comes back up.

By enabling sticky-dr on this interface, it will continue to act as the DR for the LAN even after the old DR comes back up.

The no form of the command disables sticky-dr operation on this interface.

Default 

no sticky-dr (disabled)

Parameters 
priority dr-priority
sets the DR priority to be sent in PIM Hello messages following the election of that interface as the DR, when sticky-dr operation is enabled
Values—
1 to 4294967295

 

three-way-hello

Syntax 
[no] three-way-hello
Context 
config>router>pim>interface
Description 

This command enables three-way hello. By default, three-way hello is disabled on all interfaces and the standard two-way hello is supported.

Default 

no three-way-hello

tracking-support

Syntax 
[no] tracking-support
Context 
config>router>pim>interface
Description 

This command sets the T-bit in the LAN Prune Delay option of the Hello Message. This indicates the router’s capability to enable join message suppression. This capability allows for upstream routers to explicitly track Join memberships.

Default 

no tracking-support

non-dr-attract-traffic

Syntax 
[no] non-dr-attract-traffic
Context 
config>router>pim
Description 

This command specifies whether the router should ignore the designated router state and attract traffic even when it is not the designated router.

An operator can configure an interface (router or IES) to IGMP for PIM. The interface IGMP state will be synchronized to the backup node if it is associated with the redundant peer port. The interface can be configured to use PIM, which will cause multicast streams to be sent to the elected DR only. The DR will also be the router sending traffic to the DSLAM. Since it may be required to attract traffic to both routers, a non-dr-attract-traffic flag can be used in the PIM context to have the router ignore the DR state and attract traffic if it is not the DR. While using this flag, the router may not send the stream down to the DSLAM while it is not the DR.

When enabled, the designated router state is ignored. When disabled, the designated router value is honored.

Default 

no non-dr-attract-traffic

rp

Syntax 
rp
Context 
config>router>pim
Description 

This command provides access to the bootstrap import and export policy commands.

The 7705 SAR cannot become a Rendezvous Point (RP); however, it may be present in a network that has one or more RPs. The 7705 SAR handles Register messages by allowing the configuration of policies that will drop incoming Register messages silently, or send register-stop messages if the policy action is set to “accept” or if no policy action is assigned.

anycast

Syntax 
[no] anycast rp-ip-address
Context 
config>router>pim>rp
Description 

This command configures a PIM anycast protocol instance for the RP being configured. Anycast enables fast convergence when a PIM RP router fails by allowing receivers and sources to rendezvous at the closest RP.

The no form of the command removes the anycast instance from the configuration.

Default 

n/a

Parameters 
rp-ip-address—
specifies the loopback IP address shared by all routes that form the RP set for this anycast instance. Only a single address can be configured. If another anycast command is entered with an address, the old address is replaced with the new address. If no IP address is entered, the command is used to enter the anycast CLI level.
Values—
any valid loopback address configured on the node

 

rp-set-peer

Syntax 
[no] rp-set-peer ip-address
Context 
config>router>pim>rp>anycast
Description 

This command configures a peer in the anycast-RP set. The ip-address identifies the address used by the other node as the RP candidate address for the same multicast group address range as configured on this node.

Caution:

This is a manual procedure. Caution should be taken to produce a consistent configuration of an RP set for a multicast group address range. The priority should be identical on each node and be a higher value than any other configured RP candidate that is not a member of this RP set.

Although there is no set maximum number of addresses that can be configured in an RP set, a maximum of 15 IP addresses is recommended.

The no form of the command removes an entry from the list.

Default 

n/a

Parameters 
ip-address—
specifies a peer in the anycast-RP set
Values—
any valid ip-address within the scope outlined above

 

auto-rp-discovery

Syntax 
[no] auto-rp-discovery
Context 
config>router>pim>rp
Description 

This command enables auto-RP protocol in discovery mode. In discovery mode, RP-mapping and RP-candidate messages are received and forwarded to downstream nodes. RP-mapping messages are received locally to learn about the availability of RP nodes present in the network.

Either bsr-candidate for IPv4 or auto-rp-discovery can be configured; the two mechanisms cannot be enabled together.

The no form of the command disables auto-RP discovery.

Default 

no auto-rp-discovery

bootstrap-export

Syntax 
bootstrap-export policy-name [..policy-name (up to 5 max)]
no bootstrap-export
Context 
config>router>pim>rp
Description 

This command applies export policies to the PIM configuration. The policies control the flow of bootstrap messages from the RP. Up to five policy names can be specified.

Bootstrap export policies are created using the config>router>policy-options>policy-statement command. For more information on configuring bootstrap policies, refer to the “Configuring Bootstrap Message Import and Export Policies” section of the 7705 SAR Router Configuration Guide.

Default 

no bootstrap-export

Parameters 
policy-name—
the export policy name up

bootstrap-import

Syntax 
bootstrap-import policy-name [..policy-name (up to 5 max)]
no bootstrap-import
Context 
config>router>pim>rp
Description 

This command applies import policies to the PIM configuration. The policies control the flow of bootstrap messages to the RP. Up to five policy names can be specified.

Bootstrap import policies are created using the config>router>policy-options>policy-statement command. For more information on configuring bootstrap policies, refer to the “Configuring Bootstrap Message Import and Export Policies” section of the 7705 SAR Router Configuration Guide.

Default 

no bootstrap-import

Parameters 
policy-name—
the import policy name

bsr-candidate

Syntax 
bsr-candidate
Context 
config>router>pim>rp
Description 

This command enables the context to configure candidate bootstrap router (BSR) parameters.

Either bsr-candidate for IPv4 or auto-rp-discovery can be configured; the two mechanisms cannot be enabled together.

Default 

bsr-candidate shutdown

address

Syntax 
address ip-address
Context 
config>router>pim>rp>bsr-candidate
Description 

This command is used to configure the candidate BSR IP address. This address is for bootstrap router election.

Default 

none

Parameters 
ip-address—
specifies the IP host address that will be used by the IP interface within the subnet. This address must be a unique unicast address within the subnet and specified in dotted decimal notation (1.0.0.0 to 223.255.255.255).
Values—
a.b.c.d

 

hash-mask-len

Syntax 
hash-mask-len hash-mask-length
no hash-mask-len
Context 
config>router>pim>rp>bsr-candidate
Description 

This command is used to configure the length of the mask that is combined with the group address before the hash function is called. All groups with the same hash result will map to the same RP. For example, if the hash-mask-length value is 24, only the first 24 bits of the group addresses matter. This mechanism is used to map one group or multiple groups to an RP.

Parameters 
hash-mask-length—
specifies the hash mask length
Values—
0 to 32

 

priority

Syntax 
priority bootstrap-priority
no priority
Context 
config>router>pim>rp>bsr-candidate
Description 

This command configures the bootstrap priority of the router. The RP is sometimes called the bootstrap router. The priority determines if the router is eligible to be a bootstrap router. In the case of a tie, the router with the highest IP address is elected to be the bootstrap router.

Default 

0

Parameters 
bootstrap-priority—
specifies the priority to become the bootstrap router. The higher the value, the higher the priority. A value of 0 means the router is not eligible to be the bootstrap router. A value of 1 means router is the least likely to become the designated router.
Values—
0 to 255

 

rp-candidate

Syntax 
rp-candidate
Context 
config>router>pim>rp
Description 

This command enables the context to configure the candidate rendezvous point (RP) parameters.

Routers use a set of available rendezvous points distributed in bootstrap messages to get the proper group-to-RP mapping. A set of routers within a domain are also configured as candidate RPs; typically, these will be the same routers that are configured as candidate BSRs.

Every multicast group has a shared tree through which receivers learn about new multicast sources and new receivers learn about all multicast sources. The RP is the root of this shared tree.

Default 

shutdown

address

Syntax 
address ip-address
no address
Context 
config>router>pim>rp>rp-candidate
Description 

This command configures the local RP address. This address is sent in the RP candidate advertisements to the bootstrap router.

Default 

none

Parameters 
ip-address—
specifies the ip-address of the RP
Values—
1.0.0.0 to 223.255.255.255

 

group-range

Syntax 
[no] group-range {grp-ip-address/mask | grp-ip-address netmask}
Context 
config>router>pim>rp>rp-candidate
Description 

This command configures a range of addresses for the RP candidate group.

Default 

none

Parameters 
grp-ip-address—
specifies the multicast group IP address expressed in dotted decimal notation (224.0.0.0 to 239.255.255.255)
Values—
a.b.c.d (multicast group address)

 

mask—
specifies the mask associated with the IP prefix expressed as a mask length or in dotted decimal notation; for example /16 for a sixteen-bit mask. The mask can also be entered in dotted decimal notation (255.255.0.0).
Values—
4 to 32

 

netmask—
specifies the subnet mask in dotted decimal notation (0.0.0.0 to 255.255.255.255)
Values—
a.b.c.d (network bits all 1 and host bits all 0)

 

holdtime

Syntax 
holdtime holdtime
no holdtime
Context 
config>router>pim>rp>rp-candidate
Description 

This command configures the length of time, in seconds, that neighbors should consider the sending router to be operationally up. A local RP cannot be configured on a logical router.

Parameters 
holdtime—
specifies the hold time, in seconds
Default—
150
Values—
5 to 255

 

priority

Syntax 
priority priority
no priority
Context 
config>router>pim>rp>rp-candidate
Description 

This command configures the candidate RP priority for becoming a rendezvous point (RP). This value is used to elect the RP for a group range.

Default 

192

Parameters 
priority—
specifies the priority to become a rendezvous point (RP). A value of 0 is considered as the highest priority.
Default—
192
Values—
0 to 255

 

static

Syntax 
static
Context 
config>router>pim>rp
Description 

This command enables the context to configure static rendezvous point (RP) addresses for a multicast group range.

Entries can be created or destroyed. If no IP addresses are configured in the config>router>pim>rp>static>address context, then the multicast group-to-RP mapping is derived from the RP-set messages received from the bootstrap router.

address

Syntax 
address ip-address
no address
Context 
config>router>pim>rp>static
Description 

This command indicates the rendezvous point (RP) address that is used by the router for the range of multicast groups configured by the range command.

Default 

none

Parameters 
ip-address—
specifies the IP host address that will be used by the IP interface within the subnet. This address must be a unique unicast address within the subnet and specified in dotted decimal notation (1.0.0.0 to 223.255.255.255).
Values—
a.b.c.d

 

group-prefix

Syntax 
[no] group-prefix {grp-ip-address/mask | grp-ip-address netmask}
Context 
config>router>pim>rp>static>address
Description 

The command defines a range of multicast IP addresses for which an RP is applicable.

The no form of the command removes the address range.

Default 

n/a

Parameters 
grp-ip-address—
specifies the multicast IP address
Values—
a.b.c.d (multicast group address)

 

mask—
specifies the mask of the multicast IP address
Values—
4 to 32

 

netmask—
specifies the subnet mask in dotted decimal notation
Values—
a.b.c.d (network bits all 1 and host bits all 0)

 

override

Syntax 
[no] override
Context 
config>router>pim>rp>static>address
Description 

This command changes the precedence of static RP over dynamically learned RP.

When enabled, the static group-to-RP mappings take precedence over the dynamically learned mappings.

Default 

no override

rpf-table

Syntax 
rpf-table {rtable-m | rtable-u | both}
no rpf-table
Context 
config>router>pim
Description 

This command configures the sequence of route tables used to find a Reverse Path Forwarding (RPF) interface for a particular multicast route.

By default, only the unicast route table is looked up to calculate the RPF interface towards the source/rendezvous point. However the operator can specify the following:

  1. use unicast route table only
  2. use multicast route table only
  3. use both route tables
Default 

rtable-u

Parameters 
rtable-m—
specifies that only the multicast route table will be used by the multicast protocol (PIM) for IPv4 RPF checks. This route table will contain routes submitted by static routes, IS-IS and OSPF.
rtable-u—
specifies that only the unicast route table will be used by the multicast protocol (PIM) for IPv4 RPF checks. This route table will contain routes submitted by all the unicast routing protocols.
both—
specifies that PIM will always use the multicast route table first, and if there is a route, it will use it. If PIM does not find a route in the first lookup, it will try to find it in the unicast route table.

rpf6-table

Syntax 
rpf6-table {rtable6-m | rtable6-u | both}
no rpf6-table
Context 
config>router>pim
Description 

This command configures the sequence of route tables used to find a Reverse Path Forwarding (RPF) interface for a particular multicast route.

By default, only the unicast route table is looked up to calculate the RPF interface towards the source/rendezvous point. However the operator can specify the following:

  1. use unicast route table only
  2. use multicast route table only
  3. use both route tables
Default 

rtable6-u

Parameters 
rtable6-m—
specifies that only the multicast route table will be used by the multicast protocol (PIM) for IPv6 RPF checks. This route table will contain routes submitted by static routes and OSPF.
rtable6-u—
specifies that only the unicast route table will be used by the multicast protocol (PIM) for IPv6 RPF checks. This route table will contain routes submitted by all the unicast routing protocols.
both—
specifies that PIM will always use the multicast route table first, and if there is a route, it will use it. If PIM does not find a route in the first lookup, it will try to find it in the unicast route table.

spt-switchover-threshold

Syntax 
spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask | grp-ipv6-prefix/ipv6-prefix-length} spt-threshold
no spt-switchover-threshold {grp-ipv4-prefix/ipv4-prefix-length | grp-ipv4-prefix netmask | grp-ipv6-prefix/ipv6-prefix-length}
Context 
config>router>pim
Description 

This command configures the shortest path tree (SPT) switchover thresholds for group prefixes.

PIM-SM routers with directly connected routers receive multicast traffic initially on a shared tree rooted at the RP. When the traffic arrives on the shared tree and the source of the traffic is known, a switchover to the SPT rooted at the source is attempted.

For a group that falls in the range of a prefix configured in the table, the corresponding threshold value determines when the router should switch over from the shared tree to the source-specific tree. The switchover is attempted only if the traffic rate on the shared tree for the group exceeds the configured threshold.

If there is no matching prefix in the table, the default behavior is to switch over when the first packet is seen. If there are multiple prefixes matching a group, the most specific entry is used.

Default 

n/a

Parameters 
grp-ipv4-prefix—
specifies the group IPv4 multicast address in dotted decimal notation
Values—
a.b.c.d (multicast ip address)

 

ipv4-prefix-length—
specifies the length of the IPv4 prefix
Values—
4 to 32

 

netmask—
specifies the netmask associated with the IPv4 prefix, expressed in dotted decimal notation. Network bits must be 1, and host bits must be 0.
Values—
a.b.c.d (network bits all 1 and host bits all 0)

 

grp-ipv6-prefix—
specifies the group IPv6 multicast address in hexadecimal notation
Values—
ffxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx (eight 16-bit pieces)
x:x:x:x:x:x:d.d.d.d
  xx: [0 to FF]H
  d:  [0 to 255]D

 

ipv6-prefix-length—
the length of the IPv6 prefix
Values—
8 to 128

 

spt-threshold—
specifies the configured threshold in kilobits per second (kbps) for a group prefix. A switchover is attempted only if the traffic rate on the shared tree for the group exceeds this configured threshold. When the infinity keyword is specified, no switchover will occur at any time, regardless of the traffic level detected.
Values—
1 to 4294967294 | infinity (threshold in kbps)

 

ssm-default-range-disable

Syntax 
[no] ssm-default-range-disable ipv4
[no] ssm-default-range-disable ipv6
Context 
config>router>pim
Description 

This command enables and disables the IPv4 and IPv6 SSM default ranges.

Default 

no ssm-default-range-disable ipv4 no ssm-default-range-disable ipv6

Parameters 
ipv4—
specifies IPv4 as the SSM default range
ipv6—
specifies IPv6 as the SSM default range

ssm-groups

Syntax 
[no] ssm-groups
Context 
config>router>pim
Description 

This command enables the context to configure an SSM group range.

group-range

Syntax 
[no] group-range {ip-prefix/mask | ip-prefix netmask}
Context 
config>router>pim>ssm-groups
Description 

This command configures the address ranges of the multicast groups for this router. When there are parameters present, the command configures the SSM group ranges for IPv6 addresses and netmasks.

Default 

none

Parameters 
ip-prefix/mask—
specifies the IP prefix for the range used by the ABR to advertise that summarizes the area into another area
Values—
ipv4-prefix:               a.b.c.d
ipv4-prefix-length:    0 to 30
ipv6-prefix:               x:x:x:x:x:x:x:x (eight 16-bit pieces)
                                x:x:x:x:x:x:d.d.d.d
                                x: [0..FFFF]H
                                d: [0..255]D
ipv6-prefix-length:   0 to 126

 

netmask—
specifies subnet mask in dotted decimal notation
Values—
a.b.c.d (network bits all 1 and host bits all 0)

 

3.15.2.1.5. MSDP Commands

msdp

Syntax 
[no] msdp
Context 
config>router
Description 

This command enables a Multicast Source Discovery Protocol (MSDP) instance. When an MSDP instance is created, the protocol is enabled. To start or suspend execution of the MSDP protocol without affecting the configuration, use the [no] shutdown command.

For MSDP to function, at least one peer must be configured.

When MSDP is configured and started an appropriate event message is generated.

Before the no form of the command is executed, all sessions must be terminated and an appropriate event message will be generated.

When all peering sessions are terminated, an event message per peer is not required.

The no form of the command deletes the MSDP instance, removing all associated configuration parameters.

Default 

no msdp

active-source-limit

Syntax 
active-source-limit number
no active-source-limit
Context 
config>router>msdp
config>router>msdp>group
config>router>msdp>group>peer
Description 

This option controls the maximum number of active source messages that will be accepted by Multicast Source Discovery Protocol (MSDP), effectively controlling the number of active sources that can be stored on the system.

The no form of this command reverts the number of source message limit to default operation.

Default 

none (no limit is placed on the number of source-active records)

Parameters 
number—
this parameter defines how many active sources can be maintained by MSDP
Values—
0 to 1000000

 

receive-msdp-msg-rate

Syntax 
receive-msdp-msg-rate number interval seconds [threshold number]
no receive-msdp-msg-rate
Context 
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
Description 

This command limits the number of Multicast Source Discovery Protocol (MSDP) messages that are read from the TCP session because it is possible that an MSDP RP router may receive a large number of MSDP message packets in a particular source-active message.

After the number of MSDP packets (including source-active messages) defined by the threshold number have been processed, the rate of all other MSDP packets is rate limited. Messages from the TCP session are no longer accepted until the interval (seconds) has elapsed.

The no form of this command reverts this active-source limit to default operation.

Default 

none (no limit is placed on the number of MSDP and source-active limit messages that will be accepted)

Parameters 
receive-msdp-msg-rate number
specifies the number of MSDP messages (including source-active messages) that are read from the TCP session per interval seconds
Values—
10 to 10000

 

Default—
0
interval seconds
specifies the interval of time that, together with receive-msdp-msg-rate number, sets the number of MSDP messages (including source-active messages) that are read from the TCP session within the configured number of seconds
Values—
1 to 600

 

Default—
0
threshold number
specifies the number of MSDP messages can be processed before the MSDP message rate limiting function (described above) is activated; this is useful during at system startup and initialization
Values—
1 to 1000000

 

Default—
0

authentication-key

Syntax 
authentication-key [authentication-key | hash-key] [hash | hash2]
no authentication-key
Context 
config>router>msdp>peer
config>router>msdp>group>peer
Description 

This command configures a Message Digest 5 (MD5) authentication key to be used with a specific Multicast Source Discovery Protocol (MSDP) peering session. The authentication key must be configured per peer, therefore no global or group configuration is possible.

Default 

authentication-key (all MSDP messages are accepted and the MD5 signature option authentication key is disabled)

Parameters 
authentication-key—
specifies the authentication key. Allowed values are any string up to 256 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), enclose the entire string in quotation marks (“ ”).
hash-key—
specifies the hash key. The key can be any combination of ASCII characters up to 451 characters in length (encrypted). If spaces are used in the string, enclose the entire string in quotation marks (“ ”).

This is useful when a user must configure the parameter, but, for security purposes, the actual unencrypted key value is not provided.

hash—
specifies that the key is entered in an encrypted form. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.
hash2—
specifies that the key is entered in a more complex encrypted form that involves more variables than the key value alone, meaning that the hash2 encrypted variable cannot be copied and pasted. If the hash or hash2 parameter is not used, the key is assumed to be in an unencrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash or hash2 parameter specified.

data-encapsulation

Syntax 
[no] data-encapsulation
Context 
config>router>msdp
Description 

This command configures a rendezvous point (RP) using Multicast Source Discovery Protocol (MSDP) to encapsulate multicast data received in MSDP register messages inside forwarded MSDP source-active messages.

Default 

data-encapsulation

default-peer

Syntax 
[no] default-peer
Context 
config>router>msdp>peer
config>router>msdp>group>peer
Description 

This command configures the use of the default peer mechanism, where a peer can be selected as the default Multicast Source Discovery Protocol (MSDP) peer. As a result, all source-active messages from the peer will be accepted without the usual peer reverse path forwarding (RPF) check.

The MSDP peer-RPF check is different from the normal multicast RPF checks. The peer-RPF check is used to stop source-active messages from looping. A router validates source-active messages originated from other routers in a deterministic fashion.

A set of rules is applied to validate received source-active messages, and the first rule that applies determines the peer-RPF neighbor. All source-active messages from other routers are rejected. The following rules are applied to source-active messages originating at router_S and received at router_R from router_N.

  1. If router_N and router_S are one and the same, then the message is originated by a direct peer-RPF neighbor and will be accepted.
  2. If router_N is a configured peer or a member of the router_R mesh group, then its source-active messages are accepted.
  3. If router_N is the Border Gateway Protocol (BGP) next hop of the active multicast RPF route toward router_S, then router_N is the peer-RPF neighbor and its source-active messages are accepted.
  4. If router_N is an external BGP peer of router_R and the last autonomous system (AS) number in the BGP AS-path to router_S is the same as router_N’s AS number, then router_N is the peer-RPF neighbor and its source-active messages are accepted.
  5. If router_N uses the same next hop as the next hop to router_S, then router_N is the peer-RPF neighbor and its source-active messages are accepted.
  6. If router_N fits none of the above rules, then router_N is not a peer-RPF neighbor and its source-active messages are rejected.
Default 

none (no default peer is established and all active source messages must be RPF checked)

export

Syntax 
export policy-name [policy-name...(up to 5 max)]
no export
Context 
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
Description 

This command specifies the policies to export source-active state from the source-active list into Multicast Source Discovery Protocol (MSDP).

If multiple policy names are specified, the policies are evaluated in the order they are specified. The first policy that matches is applied. If multiple export commands are issued, the last command entered will override the previous command. A maximum of five policy names can be specified.

The no form of the command removes all policies from the configuration.

Default 

No export policies are applied and all SA entries are announced.

Parameters 
policy-name—
specifies the export policy name. Up to five policy-name arguments can be specified.

If you configure an export policy at the global level, each individual peer inherits the global policy. If you configure an export policy at the group level, each individual peer in a group inherits the group’s policy. If you configure an export policy at the peer level, then policy only applies to the peer where it is configured.

group

Syntax 
[no] group group-name
Context 
config>router>msdp
Description 

This command enables access to the context to create or modify a Multicast Source Discovery Protocol (MSDP) group. To configure multiple MSDP groups, include multiple group statements.

By default, the group’s options are inherited from the global MSDP options. To override the global options, group-specific options within the group statement can be configured.

If the group name provided is already configured then this command only provides the context to configure the options pertaining to this group.

If the group name provided is not already configured, then the group name must be created and the context to configure the parameters pertaining to the group should be provided.

For a group to be of use, at least one peer must be configured.

Default 

no group

Parameters 
group-name—
species a unique name for the MSDP group

import

Syntax 
import policy-name [policy-name...(up to 5 max)]
no import
Context 
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
Description 

This command specifies the policies to import source-active state from Multicast Source Discovery Protocol (MSDP) into source-active list.

If multiple policy names are specified, the policies are evaluated in the order they are specified. The first policy that matches is applied. If multiple import commands are issued, the last command entered will override the previous command. A maximum of five policy names can be specified.

If you configure an import policy at the global level, each individual peer inherits the global policy.

If you configure an import policy at the group level, each individual peer in a group inherits the group’s policy.

If you configure an import policy at the peer level, then policy only applies to the peer where it is configured.

The no form of the command removes all policies from the configuration.

Default 

none (no import policies are applied and all source-active messages are allowed)

Parameters 
policy-name—
specifies the import policy name (up to five policy-name arguments can be specified)

local-address

Syntax 
local-address address
no local-address
Context 
config>router>msdp
config>router>msdp>peer
config>router>msdp>group
config>router>msdp>group>peer
Description 

This command configures the local end of a Multicast Source Discovery Protocol (MSDP) session. For MSDP to function, at least one peer must be configured. When configuring a peer, you must include this local-address command to configure the local end of the MSDP session. This address must be present on the node and is used to validate incoming connections to the peer and to establish connections to the remote peer.

If the user enters this command, then the address provided is validated and will be used as the local address for MSDP peers from that point. If a subsequent local-address command is entered, it will replace the existing configuration and existing sessions will be terminated.

Similarly, when the no form of this command is entered, the existing local-address will be removed from the configuration and the existing sessions will be terminated.

Whenever a session is terminated, all information pertaining to and learned from that peer will be removed.

Whenever a new peering session is created or a peering session is lost, an event message should be generated.

The no form of this command removes the local-address from the configuration.

Default 

none (no local address is configured)

Parameters 
address—
specifies an existing address on the node

mode

Syntax 
mode {mesh-group | standard}
Context 
config>router>msdp>group
Description 

This command configures groups of peers in a full mesh topology to limit excessive flooding of source-active messages to neighboring peers.

In a meshed configuration, all members of the group must have a peer connection with every other mesh group member. If this rule is not adhered to, then unpredictable results may occur.

Default 

standard (non-meshed)

Parameters 
mesh-group—
specifies that source-active messages received from a mesh group member are always accepted but are not flooded to other members of the same mesh group. These source-active messages are only flooded to non-mesh group peers or members of other mesh groups.
standard—
specifies a non-meshed mode.

peer

Syntax 
[no] peer peer-address
Context 
config>router>msdp
config>router>msdp>group
Description 

This command configures peer parameters. Multicast Source Discovery Protocol (MSDP) must have at least one peer configured. A peer is defined by configuring a local-address that can be used by this node to set up a peering session and the address of a remote MSDP router, It is the address of this remote peer that is configured in this command and it identifies the remote MSDP router address.

After peer relationships are established, the MSDP peers exchange messages to advertise active multicast sources. It may be required to have multiple peering sessions in which case multiple peer statements should be included in the configurations.

By default, the options applied to a peer are inherited from the global or group-level. To override these inherited options, include peer-specific options within the peer statement.

If the peer address provided is already a configured peer, then this command only provides the context to configure the parameters pertaining to this peer.

If the peer address provided is not already a configured peer, then the peer instance must be created and the context to configure the parameters pertaining to this peer should be provided. In this case, the $ prompt is used, indicating that a new entity (peer) is being created.

The peer address provided will be validated and, if valid, will be used as the remote address for an MSDP peering session.

When the no form of this command is entered, the existing peering address is removed from the configuration and the existing session is terminated. Whenever a session is terminated, all source-active information pertaining to and learned from that peer is removed. Whenever a new peering session is created or a peering session is lost, an event message is generated.

At least one peer must be configured for MSDP to function.

Default 

none

Parameters 
peer-address—
specifies the peer address that must identify the remote MSDP router with which the peering session must be established

rpf-table

Syntax 
rpf-table {rtable-m | rtable-u | both}
no rpf-table
Context 
config>router>msdp
Description 

This command configures the sequence of route tables used to find a Reverse Path Forwarding (RPF) interface for a particular multicast route.

By default, only the unicast route table is looked up to calculate RPF interface towards the source/rendezvous point. However, the operator can specify one of the following options:

  1. use the unicast route table only
  2. use the multicast route table only
  3. use both the route tables
Default 

rtable-u

Parameters 
rtable6-m—
specifies that only the multicast route table is used by the multicast protocol (PIM) for IPv4 RPF checks. This route table contains routes submitted by static routes, ISIS, and OSPF.
rtable6-u—
specifies that only the unicast route table is used by the multicast protocol (PIM) for IPv4 RPF checks. This route table contains routes submitted by all the unicast routing protocols.
both—
specifies that the first lookup is always in the multicast route table and, if there is a route, it will use it. If PIM does not find a route in the first lookup, it tries to find it in the unicast route table (that is, rtable6-m is checked before rtable6-u).

sa-timeout

Syntax 
sa-timeout seconds
no sa-timeout
Context 
config>router>msdp
Description 

This command configures the value for the SA entries in the cache. If these entries are not refreshed within the timeout value, they are removed from the cache. Normally, the entries are refreshed at least once a minute. But under high load with many of MSDP peers, the refresh cycle could be incomplete. A higher timeout value (more than 90) could be useful to prevent instabilities in the MSDP cache.

Default 

90

Parameters 
seconds—
specifies the time, in seconds, to wait for a response from the peer before declaring the peer unavailable
Values—
90 to 600

 

source

Syntax 
[no] source ip-prefix/mask
Context 
config>router>msdp
Description 

This command limits the number of active source messages the router accepts from sources in the specified address range.

If the prefix and mask provided is already configured then this command only provides the context to configure the parameters pertaining to this active source message filter.

If the prefix and mask provided is not already a configured, then the source node instance must be created and the context to configure the parameters pertaining to this node should be provided. In this case, the $ prompt indicates that a new entity (source) is being created.

The no form of this command removes the source-active rate limiter for this source address range.

Default 

none (the source-active msdp messages are not rate limited based on the source address range)

Parameters 
ip-prefix—
specifies the IP prefix, in dotted decimal notation, for the range used by the ABR to advertise that summarizes the area into another area
Values—
a.b.c.d (host bits must be 0)

 

mask—
specifies the subnet mask for the range, expressed as a decimal integer mask length or in dotted decimal notation
Values—
0 to 32 (mask length)
0.0.0.0 to 255.255.255.255 (dotted decimal)

 

3.15.2.2. Show Commands

Note:

The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

igmp

Syntax 
igmp
Context 
show>router
Description 

This command enables the context to display IGMP information.

group

Syntax 
group [grp-ip-address]
group summary
Context 
show>router>igmp
Description 

This command displays the multicast group and (S,G) addresses. If no grp-ip-address parameters are specified, then all IGMP group, (*,G) and (S,G) addresses are displayed.

Parameters 
grp-ip-address—
displays specific multicast group addresses
Output 

The following output is an example of IGMP group information, and Table 4 describes the fields.

Output Example
*B:Dut-C# show router igmp group 
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups
===============================================================================
(*,225.0.0.1) 
    Fwd List : 112.112.1.2                Up Time : 0d 00:00:21
(11.11.0.1,225.0.0.1) 
    Fwd List : 112.112.1.1                Up Time : 0d 00:00:30 
    Blk List : 112.112.1.2                Up Time : 0d 00:00:21
(11.11.0.2,225.0.0.1) 
    Fwd List : 112.112.1.1                Up Time : 0d 00:00:30
(*,225.0.0.2) 
    Fwd List : 112.112.1.2                Up Time : 0d 00:00:21
(11.11.0.1,225.0.0.2) 
    Blk List : 112.112.1.2                Up Time : 0d 00:00:21
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C#
*B:Dut-C# show router igmp group summary
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups Summary         Nbr Fwd Hosts         Nbr Blk Hosts
===============================================================================
(*,225.0.0.1) 1 0
(11.11.0.1,225.0.0.1)            1                     1
(11.11.0.2,225.0.0.1)            1                     0
(*,225.0.0.2)                    1                     0
(11.11.0.1,225.0.0.2)            0                     1
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C#
Table 4:  Show IGMP Group Output Fields 

Label

Description

IGMP Host Groups Summary

The IP multicast sources corresponding to the IP multicast groups that are statically configured

Nbr Fwd Hosts

The number of forwarding hosts

Nbr Blk Hosts

The number of blocking hosts

interface

Syntax 
interface [ip-int-name | ip-address] [group] [grp-ip-address] [detail]
Context 
show>router>igmp
Description 

This command displays IGMP interface information.

Parameters 
ip-int-name—
displays only the information associated with the specified IP interface name
ip-address—
displays only the information associated with the specified IP address
grp-ip-address—
displays only the IP multicast group address for which this entry contains information
detail—
displays detailed IP interface information along with the source group information learned on that interface
Output 

The following output is an example of IGMP interface information, and Table 5 describes the fields.

Output Example
*A:ALU-BA# show router 100 interface
===============================================================================
Interface Table (Service: 100)
===============================================================================
Interface-Name           Adm          Opr(v4/v6)     Mode      Port/SapId
   IP-Address                                                  PfxState
-------------------------------------------------------------------------------
IGMP_to_CE               Up           Up             VPRN      1/1/7
   11.1.1.1/24 n/a
system                   Up           Up             VPRN      loopback
   10.20.1.2/32 n/a
-------------------------------------------------------------------------------
Interfaces : 2
===============================================================================
*A:ALU-BA#
*A:ALU-BA# show router 100 interface IGMP_to_CE
===============================================================================
Interface Table (Service: 100)
===============================================================================
Interface-Name           Adm          Opr(v4/v6)     Mode      Port/SapId
   IP-Address                                                  PfxState
-------------------------------------------------------------------------------
IGMP_to_CE               Up           Up             VPRN      1/1/7
   11.1.1.1/24                                                 n/a
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALU-BA#
*A:ALU-BA# show router 100 igmp interface 
===============================================================================
IGMP Interfaces
===============================================================================
Interface       Adm       Oper     Querier     Cfg/Opr   Num      Policy 
                                               Version   Groups 
-------------------------------------------------------------------------------
IGMP_to_CE      Up        Up       11.1.1.1    1/1        3       igmppol 
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALU-BA#
*A:ALU-BA# show router 100 igmp interface IGMP_to_CE
===============================================================================
IGMP Interface IGMP_to_CE
===============================================================================
Interface       Adm       Oper     Querier     Cfg/Opr   Num      Policy 
                                               Version   Groups 
-------------------------------------------------------------------------------
IGMP_to_CE      Up        Up       11.1.1.1    1/1        3       igmppol 
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALU-BA#
*A:ALU-BA# show router 100 igmp interface 11.1.1.1 
===============================================================================
IGMP Interface 11.1.1.1
===============================================================================
Interface       Adm       Oper     Querier     Cfg/Opr   Num      Policy 
                                               Version   Groups 
-------------------------------------------------------------------------------
IGMP_to_CE      Up        Up       11.1.1.1    1/1        3       igmppol 
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALU-BA#
*A:ALU-BA# show router 100 igmp interface IGMP_to_CE group 227.1.1.1 
===============================================================================
IGMP Interface IGMP_to_CE
===============================================================================
Interface       Adm       Oper     Querier     Cfg/Opr   Num      Policy 
                                               Version   Groups 
-------------------------------------------------------------------------------
IGMP_to_CE      Up        Up       11.1.1.1    1/1        3       igmppol 
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address : 227.1.1.1              Up Time      : 0d 00:03:52 
Interface     : IGMP_to_CE             Expires      : never 
Last Reporter : 0.0.0.0                Mode         : exclude 
V1 Host Timer : Not running            Type         : static 
V2 Host Timer : Not running            Compat Mode  : IGMP Version 3 
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALU-BA#
*A:ALU-BA# show router 100 igmp interface IGMP_to_CE group 227.1.1.1 detail 
===============================================================================
IGMP Interface IGMP_to_CE
===============================================================================
Interface           : IGMP_to_CE 
Admin Status        : Up                Oper Status         : Up 
Querier             : 11.1.1.1          Querier Up Time     : 0d 00:04:01 
Querier Expiry Time : N/A               Time for next query : 0d 00:13:42 
Admin/Oper version  : 1/1               Num Groups          : 3 
Policy              : igmppol           Subnet Check        : Disabled 
Max Groups Allowed  : 16000             Max Groups Till Now : 3 
MCAC Policy Name    : MCAC              Const Adm St        : Enable 
MCAC Max Unconst BW : no limit          MCAC Max Mand BW    : no limit 
MCAC In use Mand BW : 0                 MCAC Avail Mand BW  : unlimited 
MCAC In use Opnl BW : 0                 MCAC Avail Opnl BW  : unlimited 
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address       : 227.1.1.1         Up Time             : 0d 00:04:02 
Interface           : IGMP_to_CE        Expires             : never 
Last Reporter       : 0.0.0.0           Mode                : exclude 
V1 Host Timer       : Not running       Type                : static 
V2 Host Timer       : Not running       Compat Mode         : IGMP Version 3 
-------------------------------------------------------------------------------
Table 5:  Show IGMP Interface Output Fields 

Label

Description

Interface

The interface that participates in the IGMP protocol

Adm

Admin Status

The administrative state for the IGMP protocol on this interface

Querier

The address of the IGMP querier on the IP subnet to which the interface is attached

Oper

Oper Status

The current operational state of the IGMP protocol on the interface

Querier Up Time

The time since the querier was last elected as querier

Querier Expiry Time

The time remaining before the querier ages out. If the querier is the local interface address, the value will be zero.

Cfg/Opr Version Admin/Oper version

Cfg — the configured version of IGMP running on this interface. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.

Opr — the operational version of IGMP running on this interface. If the cfg value is 3 but all of the routers in the local subnet of this interface use IGMPv1 or IGMPv2, the operational version will be v1 or v2 (as appropriate).

Num Groups

The number of multicast groups that have been learned by the router on the interface

Policy

The policy that is to be applied on the interface

Group Address

The IP multicast group address for which this entry contains information

Up Time

The time since this source group entry got created

Last Reporter

The IP address of the source of the last membership report received for this IP multicast group address on this interface. If no membership report has been received, this object has the value 0.0.0.0.

Mode

The mode is based on the type of membership reports received on the interface for the group

Include — reception of packets sent to the specified multicast address is requested only from those IP source addresses listed in the source-list parameter of the IGMP membership report

Exclude — reception of packets sent to the given multicast address is requested from all IP source addresses except those listed in the source-list parameter

V1 Host Timer

The time remaining until the local router assumes that there are no longer any IGMPv1 members on the IP subnet attached to this interface. Upon hearing any IGMPv1 membership report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv2 Leave messages for this group that it receives on this interface.

V2 Host Timer

The time remaining until the local router assumes that there are no longer any IGMPv2 members on the IP subnet attached to this interface. Upon hearing any IGMPv2 membership report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv3 Leave messages for this group that it receives on this interface.

Type

Indicates how this group entry was learned. If this group entry was learned by IGMP, it will be set to “dynamic”. For statically configured groups, the value will be set to “static”.

Compat Mode

Used in order for routers to be compatible with older version routers. IGMPv3 hosts must operate in version 1 and version 2 compatibility modes. IGMPv3 hosts must keep track of the state per local interface regarding the compatibility mode of each attached network.

A host’s compatibility mode is determined from the Host Compatibility Mode variable, which can be in one of three states: IGMPv1, IGMPv2 or IGMPv3. This variable is kept per interface and is dependent on the version of General Queries heard on that interface as well as the Older Version Querier Present timers for the interface.

ssm-translate

Syntax 
ssm-translate [interface-name]
Context 
show>router>igmp
Description 

This command displays IGMP SSM translate configuration information.

Parameters 
interface-name—
displays the information associated with the specified IP interface name (the interface name can have up to 32 characters and must start with a letter)
Output 

The following output is an example of IGMP ssm-translate configuration information, and Table 6 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>igmp# ssm-translate
===============================================================================
IGMP SSM Translate Entries
===============================================================================
Group Range                        Source           Interface
-------------------------------------------------------------------------------
<232.10.10.0 - 232.10.10.10>       10.10.10.10      igmp_interface
-------------------------------------------------------------------------------
SSM Translate Entries : 1
===============================================================================
*A:7705custDoc:Sar18>show>router>igmp#
Table 6:  Show IGMP SSM-Translate Output Fields 

Label

Description

Group Range

The address ranges of the multicast groups to which this router can belong

Source

The unicast address that sends data on an interface

Interface

The name of the interface

SSM Translate Entries

The total number of SSM translate entries

static

Syntax 
static [ip-int-name | ip-address]
Context 
show>router>igmp
Description 

This command displays static IGMP, (*,G), and (S,G) information.

Parameters 
ip-int-name—
displays the information associated with the specified IP interface name
ip-address—
displays the information associated with the specified IP address in the format a.b.c.d
Output 

The following output is an example of static IGMP information, and Table 7 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>igmp# static
==================================================================
IGMP Static Group Source
==================================================================
Source           Group            Interface
------------------------------------------------------------------
10.10.10.10      232.10.10.0      igmp_interface
------------------------------------------------------------------
Static (*,G)/(S,G) Entries : 1
==================================================================
Table 7:  Show Static IGMP Output Fields 

Label

Description

Source

The entries that represent a source address from which receivers are interested or not interested in receiving multicast traffic

Group

The IP multicast group address for which this entry contains information

Interface

The interface name

statistics

Syntax 
statistics [ip-int-name | ip-address]
Context 
show>router>igmp
Description 

This command displays IGMP statistics information.

Parameters 
ip-int-name—
displays the information associated with the specified IP interface name
ip-address—
displays the information associated with the specified IP address
Output 

The following output is an example of IGMP statistic information, and Table 8 describes the fields.

Output Example
*A:ALU-BA# show router igmp statistics
=================================================
IGMP Interface Statistics
=================================================
Message Type        Received     Transmitted 
--------------------------------------------------
Queries             0            5 
Report V1           0            0 
Report V2           0            0 
Report V3           10           0 
Leaves              0            0 
-------------------------------------------------
General Interface Statistics
-------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Bad Receive If    : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
-------------------------------------------------
Source Group Statistics
-------------------------------------------------
(S,G)             : 2
(*,G)             : 1
=================================================
*A:ALU-BA#
Table 8:  Show IGMP Statistics Output Fields 

Label

Description

IGMP Interface Statistics

Message Type

Queries — The number of IGMP general queries transmitted or received on this interface

Report — The total number of IGMPv1, IGMPv2, or IGMPv3 reports transmitted or received on this interface

Leaves — The total number of IGMP leaves transmitted on this interface

Received

The total number of IGMP packets received on this interface

Transmitted

The total number of IGMP packets transmitted from this interface

General Interface Statistics

Bad Length

The total number of IGMP packets with bad length received on this interface

Bad Checksum

The total number of IGMP packets with bad checksum received on this interface

Unknown Type

The total number of IGMP packets with unknown type received on this interface

Bad Receive If

The total number of IGMP packets incorrectly received on this interface

Rx Non Local

The total number of IGMP packets received from a non-local sender

Rx Wrong Version

The total number of IGMP packets with wrong versions received on this interface

Policy Drops

The total number of times that the IGMP protocol instance matched the host IP address or group/source addresses specified in the import policy

No Router Alert

The total number of IGMPv3 packets received on this interface that did not have the router alert flag set

Rx Bad Encodings

The total number of IGMP packets with bad encoding received on this interface

Local Scope Pkts

The total number of IGMP packets received with scope field of node-local on this interface

Resvd Scope Pkts

The total number of IGMP packets with reserved scope on this interface

Source Group Statistics

(S,G)

The total number of (S,G)s for IGMP

(*,G)

The total number of (*,G)s for IGMP

status

Syntax 
status
Context 
show>router>igmp
Description 

This command displays IGMP status information. If IGMP is not enabled, the following message appears:

A:NYC# show router igmp status
MINOR: CLI IGMP is not configured.
A:NYC#
Output 

The following output is an example of IGMP status information, and Table 9 describes the fields.

Output Example
*A:ALU-BA# show router 100 igmp status 
===============================================================================
IGMP Status
===============================================================================
Admin State                                : Up 
Oper State                                 : Up 
Query Interval                             : 1024 
Last Member Query Interval                 : 1024 
Query Response Interval                    : 1023 
Robust Count                               : 10 
===============================================================================
*A:ALU-BA#
Table 9:  Show IGMP Status Output Fields 

Label

Description

Admin State

The administrative status of IGMP

Oper State

The current operating state of this IGMP protocol instance on this router

Query Interval

The frequency at which IGMP query packets are transmitted

Last Member Query Interval

The maximum response time inserted into group-specific queries sent in response to leave group messages

Also, the amount of time between group-specific query messages

Query Response Interval

The maximum query response time advertised in IGMPv2 queries

Robust Count

The number of times the router will retry a query

mld

Syntax 
mld
Context 
show>router
Description 

This command enables the context to display MLD information.

group

Syntax 
group [grp-ipv6-address]
Context 
show>router>mld
Description 

This command displays MLD group information.

Parameters 
grp-ipv6-address—
the IPv6 group address
Values—
grp-ipv6-address:      x:x:x:x:x:x:x:x (eight 16-bit pieces)
                                  x:x:x:x:x:x:d.d.d.d
                                   x: [0..FFFF]H
                                   d: [0..255]D

 

Output 

The following output is an example of MLD group information, and Table 10 describes the fields.

Output Example
*A:ALU# show router mld group 
===============================================================================
MLD Groups
===============================================================================
(3FFE:100::2:100,FF05::1:1) 
    Up Time    : 0d 00:00:31 
    Fwd List   : Host1 
 
(3FFE:100::2:100,FF05::1:2) 
    Up Time    : 0d 00:00:31 
    Fwd List   : Host1 
 
(3FFE:100::2:100,FF05::1:3) 
    Up Time    : 0d 00:00:31 
    Fwd List   : Host1 
 
(3FFE:100::2:100,FF05::1:4) 
    Up Time    : 0d 00:00:31 
    Fwd List   : Host1 
 
(3FFE:100::2:100,FF05::1:5)
===============================================================================
*A:ALU#
*A:ALU# show router mld group ff05::1:1 
===============================================================================
MLD Groups
===============================================================================
(3FFE:100::2:100,FF05::1:1) 
    Up Time    : 0d 00:00:40 
    Fwd List   : Host1 
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 1
===============================================================================
*A:ALU#
Table 10:  Show MLD Group Output Fields 

Label

Description

Up Time

The length of time that the interface has been part of the MLD group

Fwd List

The forwarding list associated with the MLD group

interface

Syntax 
interface [ip-int-name | ip-address] [group] [grp-ipv6-address] [detail]
Context 
show>router>mld
Description 

This command displays MLD interface information.

Parameters 
ip-int-name—
the IP interface name
ip-address—
the IPv6 interface address (x:x:x:x:x:x:x:x)
grp-ipv6-address—
the IPv6 multicast group address
Values—
grp-ipv6-address:      x:x:x:x:x:x:x:x (eight 16-bit pieces)
                                  x:x:x:x:x:x:d.d.d.d
                                   x: [0..FFFF]H
                                   d: [0..255]D

 

detail—
displays detailed information
Output 

The following output is an example of MLD interface information, and Table 11 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>mld# interface mld_interface
===============================================================================
MLD Interface mld_interface
===============================================================================
Interface               Adm  Oper Cfg/Opr         Num             Policy
   Querier                        Version         Groups
-------------------------------------------------------------------------------
mld_interface           Up   Down 2/2             0               none
   ::
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:7705custDoc:Sar18>config>router>mld>if#
*A:7705custDoc:Sar18>show>router>mld# interface mld_interface detail
===============================================================================
MLD Interface mld_interface
===============================================================================
Interface              : mld_interface
Admin Status           : Up               Oper Status        : Down
Querier                : ::
Querier Up Time        : 0d 00:00:00
Querier Expiry Time    : N/A
Admin/Oper version     : 2/2              Num Groups         : 0
Policy                 : none
Max Groups Allowed     : No Limit         Max Groups Till Now: 0
Query Interval         : 0                Query Resp Interval: 0
Last List Qry Interval : 0                Router Alert Check : Enabled
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALU# show router mld interface 
===============================================================================
MLD Interfaces
===============================================================================
Interface                Adm     Oper    Cfg/Opr      Num        Policy 
   Querier                               Version      Groups 
-------------------------------------------------------------------------------
Host4_Srce1_IPv6         Up      Up        2/2         0          none 
   FE80::216:4DFF:FED4:4D5B
Host1                    Up      Up        2/2         0          none 
   FE80::216:4DFF:FED4:4D5B
Host2                    Up      Up        2/2         0          none 
   FE80::216:4DFF:FE51:3728
Host3_vlan1              Up      Up        2/2         0          none 
   FE80::216:4DFF:FE51:3729
Host3_vlan2              Up      Up        2/2         0          none 
   FE80::216:4DFF:FE51:3729
Host3_vlan3              Up      Up        2/2         0          none 
   FE80::216:4DFF:FE51:3729
Host3_vlan4              Up      Up        2/2         0          none 
   FE80::216:4DFF:FE51:3729
Host3_vlan5              Up      Up        2/2         0          none 
*A:ALU 
*A:ALU# show router mld interface Host1 detail 
===============================================================================
MLD Interface Host1
===============================================================================
Interface              : Host1 
Admin Status           : Up               Oper Status        : Up 
Querier                : FE80::216:4DFF:FED4:4D5B
Querier Up Time        : 0d 00:02:18 
Querier Expiry Time    : N/A              Time for next query: 0d 00:15:25 
Admin/Oper version     : 2/2              Num Groups         : 6000 
Policy                 : none 
Max Groups Allowed     : No Limit         Max Groups Till Now: 6000 
Query Interval         : 0                Query Resp Interval: 0 
Last List Qry Interval : 0                Router Alert Check : Enabled
-------------------------------------------------------------------------------
MLD Group
-------------------------------------------------------------------------------
Group Address          : FF05::1:1
Last Reporter          : FE80::1
Interface              : Host1            Expires : N/A
Up Time                : 0d 00:00:10      Mode : include
V1 Host Timer          : Not running      Type : dynamic
Compat Mode            : MLD Version 2
-------------------------------------------------------------------------------
Source
Expires                Type               Fwd/Blk
-------------------------------------------------------------------------------
3FFE:100::2:100
0d 00:34:07            dynamic            Fwd
-------------------------------------------------------------------------------
MLD Group
-------------------------------------------------------------------------------
Group Address         : FF05::1:2
Last Reporter         : FE80::1
Interface             : Host1            Expires           : N/A
Up Time               : 0d 00:00:11      Mode              : include
V1 Host Timer         : Not running      Type              : dynamic
Compat Mode           : MLD Version 2
-------------------------------------------------------------------------------
Source
Expires                Type               Fwd/Blk
-------------------------------------------------------------------------------
3FFE:100::2:100
0d 00:34:07            dynamic            Fwd
-------------------------------------------------------------------------------
MLD Group
-------------------------------------------------------------------------------
Group Address         : FF05::1:3
Last Reporter         : FE80::1
Interface             : Host1           Expires          : N/A
Up Time               : 0d 00:00:11     Mode             : include
V1 Host Timer         : Not running     Type             : dynamic
Compat Mode           : MLD Version 2
-------------------------------------------------------------------------------
Source
Expires                Type               Fwd/Blk
-------------------------------------------------------------------------------
3FFE:100::2:100
0d 00:34:07            dynamic            Fwd
-------------------------------------------------------------------------------
MLD Group
-------------------------------------------------------------------------------
Group Address         : FF05::1:4
Last Reporter         : FE80::1
Interface             : Host1             Expires         : N/A
Up Time               : 0d 00:00:12       Mode            : include
V1 Host Timer         : Not running       Type            : dynamic
Compat Mode           : MLD Version 2
-------------------------------------------------------------------------------
Source
Expires                Type               Fwd/Blk
-------------------------------------------------------------------------------
3FFE:100::2:100
0d 00:34:06            dynamic            Fwd
-------------------------------------------------------------------------------
MLD Group
-------------------------------------------------------------------------------
Group Address         : FF05::1:5
Last Reporter         : FE80::1
Interface             : Host1             Expires         : N/A
Up Time               : 0d 00:00:12       Mode            : include
V1 Host Timer         : Not running       Type            : dynamic
Compat Mode           : MLD Version 2
-------------------------------------------------------------------------------
Source
Expires                Type               Fwd/Blk
-------------------------------------------------------------------------------
3FFE:100::2:100
0d 00:34:06            dynamic            Fwd
-------------------------------------------------------------------------------
*A:ALU# show router mld interface Host1 detail 
Table 11:  Show MLD Interface Output Fields 

Label

Description

MLD Interface

Interface

The interface that participates in the MLD protocol

Admin Status

The administrative state for the MLD protocol on this interface

Oper Status

The current operational state of the MLD protocol on the interface

Querier

The address of the MLD querier on the IP subnet to which the interface is attached

Querier Up Time

The time since the querier was last elected as querier

Querier Expiry Time

The time remaining before the querier ages out. If the querier is the local interface address, the value will be zero.

Time for next query

The time until the next query is sent

Admin/Oper version

The operational version of MLD running on this interface.

If the cfg value is 2 but all of the routers in the local subnet of this interface use MLDv1, the operational version will be v1.

Num Groups

The number of multicast groups that have been learned by the router on the interface

Policy

The policy that is to be applied on the interface

Max Groups Allowed

The maximum number of groups allowed for this interface

Max Groups Till Now

The maximum number of groups joined for this interface up until the present time

Query Interval

The frequency at which MLD query packets are transmitted

Query Resp Interval

The length of time that the interface will wait for a query response

Last List Qry Interval

The maximum response time inserted into group-specific queries sent in response to leave group messages

Also, the amount of time between group-specific query messages

Router Alert Check

The status of the MLD message router alert check: enabled or disabled. When enabled (default), messages without the hop-by-hop router alert extension header in the IPv6 header will be rejected.

MLD Group

Group Address

The IPv6 multicast group address for which this entry contains information

Last Reporter

The IPv6 address of the source of the last membership report received for this IP multicast group address on this interface. If no membership report has been received, this object has the value 0.0.0.0.

Interface

The interface that participates in the MLD protocol

Expires

The length of time until the interface leaves the MLD group

Up Time

The time since this source group entry got created

Mode

The mode is based on the type of membership reports received on the interface for the group.

Include — reception of packets sent to the specified multicast address is requested only from those IP source addresses listed in the source-list parameter of the IGMP membership report

Exclude — reception of packets sent to the given multicast address is requested from all IP source addresses except those listed in the source-list parameter

V1 Host Timer

The time remaining until the local router assumes that there are no longer any MLDv1 members on the IP subnet attached to this interface. Upon hearing any MLDv1 membership report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any MLDv2 Leave messages for this group that it receives on this interface.

Type

Indicates how this group entry was learned. If this group entry was learned by MLD, it will be set to “dynamic”. For statically configured groups, the value will be set to “static”.

Compat Mode

Used in order for routers to be compatible with older version routers. MLDv2 hosts must operate in version 1 compatibility mode. MLDv2 hosts must keep track of the state per local interface regarding the compatibility mode of each attached network.

A host’s compatibility mode is determined from the Host Compatibility Mode variable, which can be in one of two states: MLDv1 or MLDv2. This variable is kept per interface and is dependent on the version of General Queries heard on that interface as well as the Older Version Querier Present timers for the interface.

Source

Expires

The length of time until the source leaves the MLD group

Type

The type of message that was used to join the source: dynamic or static

Fwd/Blk

The state of the source: forwarding or blocking

ssm-translate

Syntax 
ssm-translate [interface-name]
Context 
show>router>mld
Description 

This command displays the MLD SSM translate configuration.

Parameters 
interface-name—
displays the information associated with the specified IP interface name (the interface name can have up to 32 characters and must start with a letter)
Output 

The following output is an example of MLD ssm-translate information, and Table 12 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>mld# ssm-translate mld_interface
===============================================================================
MLD SSM Translate Entries
===============================================================================
Group Range                        Source           Interface
-------------------------------------------------------------------------------
<232.10.10.0 - 232.10.10.10>       10.10.10.10      mld_interface
-------------------------------------------------------------------------------
SSM Translate Entries : 1
===============================================================================
*A:7705custDoc:Sar18>show>router>mld#
Table 12:  Show MLD SSM-Translate Output Fields 

Label

Description

Group Range

The address range of the multicast group for this interface

Source

The unicast address that sends data on an interface

Interface

The name of the interface

SSM Translate Entries

The total number of SSM translate entries

static

Syntax 
static [ip-int-name | ip-address]
Context 
show>router>mld
Description 

This command displays MLD static group and source configuration.

Parameters 
ip-int-name—
the IP interface name
ip-address—
the IPv6 interface address in the format x:x:x:x:x:x:x:x
Output 

The following output is an example of MLD static group and source configuration information, and Table 13 describes the fields.

Output Example
*A:7705custDoc:Sar18# show router mld static 
===============================================================================
MLD Static Group Source
===============================================================================
Source                                  Group                                  
    Interface
-------------------------------------------------------------------------------
No Matching Entries
===============================================================================
*A:7705custDoc:Sar18#
Table 13:  Show MLD Static Group Output Fields 

Label

Description

Source

The entries that represent a source address from which receivers are interested or not interested in receiving multicast traffic

Group

The IP multicast group address for which this entry contains information

Interface

The IPv6 interface name

statistics

Syntax 
statistics [ip-int-name | ipv6-address]
Context 
show>router>mld
Description 

This command displays MLD statistics.

Parameters 
ip-int-name—
displays the information associated with the specified IP interface name
ipv6-address—
displays the information associated with the specified IPv6 address in the format x:x:x:x:x:x:x:x
Values—
ipv6-address:      x:x:x:x:x:x:x:x (eight 16-bit pieces)
                           x:x:x:x:x:x:d.d.d.d
                            x: [0..FFFF]H
                            d: [0..255]D

 

Output 

The following output is an example of MLD statistics information, and Table 14 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>mld# statistics
=================================================
MLD Interface Statistics
=================================================
Message Type        Received       Transmitted
-------------------------------------------------
Queries             0              0
Report V1           0              0
Report V2           0              0
Dones               0              0
-------------------------------------------------------------------------------
General Interface Statistics
-------------------------------------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Bad Receive If    : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0
Rx Pkt Drops      : 0
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
-------------------------------------------------------------------------------
Source Group Statistics
-------------------------------------------------------------------------------
(S,G)             : 0
(*,G)             : 0
=================================================
*A:7705custDoc:Sar18>show>router>mld#
Table 14:  Show MLD Statistics Output Fields 

Label

Description

MLD Interface Statistics

Message Type

Queries — the number of MLD general queries transmitted or received on this interface

Reports — the total number of MLDv1 or MLDv2 reports transmitted or received on this interface

Dones — the total number of MLD dones transmitted on this interface

Received

The total number of MLD packets received on this interface

Transmitted

The total number of MLD packets transmitted from this interface

General Interface Statistics

Bad Length

The total number of MLD packets with bad length received on this interface

Bad Checksum

The total number of MLD packets with bad checksum received on this interface

Unknown Type

The total number of MLD packets with unknown type received on this interface

Bad Receive If

The total number of MLD packets incorrectly received on this interface

Rx Non Local

The total number of MLD packets received from a non-local sender

Rx Wrong Version

The total number of MLD packets with wrong versions received on this interface

Policy Drops

The total number of times that the MLD protocol instance matched the host IP address or group/source addresses specified in the import policy

No Router Alert

The total number of MLDv2 packets received on this interface that did not have the router alert flag set

Rx Bad Encodings

The total number of MLD packets with bad encoding received on this interface

Rx Pkt Drops

The number of receive packets dropped by this interface

Local Scope Pkts

The total number of MLD packets received with scope field of node-local on this interface

Resvd Scope Pkts

The total number of MLD packets with reserved scope on this interface

Source Group Statistics

(S,G)

The total number of (S,G)s for MLD

(*,G)

The total number of (*,G)s for MLD

status

Syntax 
status
Context 
show>router>mld
Description 

This command displays the MLD status.

Output 

The following output is an example of MLD status information, and Table 15 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>mld# status
===============================================================================
MLD Status
===============================================================================
Admin State                       : Up
Oper State                        : Up
Query Interval                    : 125
Last Listener Query Interval      : 1
Query Response Interval           : 10
Robust Count                      : 2
===============================================================================
*A:7705custDoc:Sar18>show>router>mld#
Table 15:  Show MLD Status Output Fields 

Label

Description

Admin State

The administrative status of MLD

Oper State

The current operating state of this MLD protocol instance on this router

Query Interval

The frequency at which MLD query packets are transmitted

Last Listener Query Interval

The maximum response time inserted into group-specific queries sent in response to leave group messages

Also, the amount of time between group-specific query messages

Query Response Interval

The maximum query response time advertised in MLDv2 queries

Robust Count

The number of times the router will retry a query

pim

Syntax 
pim
Context 
show>router
Description 

This command enables the context to display PIM information.

group

Syntax 
group [grp-ip-address] [source ip-address] [detail] [family]
Context 
show>router>pim
Description 

This command displays PIM source group database information.

Parameters 
grp-ip-address—
the IP multicast group address for which this entry contains information
ip-address—
the source address for which this entry contains information
detail—
displays detailed group information
family—
displays either IPv4 or IPv6 information
Values—
ipv4 or ipv6

 

Output 

The following output is an example of PIM group information, and Table 16 describes the fields.

Output Example
*A:7CSA:Dut-C# show router pim group 
===============================================================================
PIM Groups ipv4
===============================================================================
Group Address                           Type     Spt Bit Inc Intf       No.Oifs
   Source Address                          RP 
-------------------------------------------------------------------------------
232.0.0.0                               (S,G)            ip-10.1.7.7    16 
   100.111.1.2 
232.0.0.1                               (S,G)            ip-10.1.7.7    16 
   100.111.1.2 
232.0.0.2                               (S,G)            ip-10.1.7.7    16 
   100.111.1.2 
232.0.0.3                               (S,G)            ip-10.1.7.7    16 
   100.111.1.2 
232.0.0.4                               (S,G)            ip-10.1.7.7    16 
   100.111.1.2 
-------------------------------------------------------------------------------
Groups : 5
===============================================================================
*A:7CSA:Dut-C# show router pim group 232.0.0.0 
===============================================================================
PIM Groups ipv4
===============================================================================
Group Address                           Type     Spt Bit Inc Intf       No.Oifs
   Source Address                          RP 
-------------------------------------------------------------------------------
232.0.0.0                               (S,G)            ip-10.1.7.7    16     
   100.111.1.2                             
-------------------------------------------------------------------------------
Groups : 1
===============================================================================
*A:7CSA:Dut-C# show router pim group 232.0.0.0 detail 
===============================================================================
PIM Source Group ipv4
===============================================================================
Group Address      : 232.0.0.0
Source Address     : 100.111.1.2
RP Address         : 0
Flags              :                    Type               : (S,G)
MRIB Next Hop      : 10.1.7.1
MRIB Src Flags     : remote             Keepalive Timer    : Not Running
Up Time            : 0d 00:27:25        Resolved By        : rtable-u
Up JP State        : Joined             Up JP Expiry       : 0d 00:00:35
Up JP Rpt          : Not Joined StarG   Up JP Rpt Override : 0d 00:00:00
Register State     : No Info                                              
Reg From Anycast RP: No                 
 
Rpf Neighbor       : 10.1.7.1
Incoming Intf      : ip-10.1.7.7
Outgoing Intf List : ip-100.112.1.1, ip-100.112.2.1, ip-100.112.3.1
                     ip-100.112.4.1, ip-100.112.5.1, ip-100.112.6.1
                     ip-100.112.7.1, ip-100.112.8.1, ip-100.112.9.1
                     ip-100.112.10.1, ip-100.112.11.1, ip-100.112.12.1
                     ip-100.112.13.1, ip-100.112.14.1, ip-100.112.15.1
                     ip-100.112.16.1
Curr Fwding Rate   : 0.0 kbps           
Forwarded Packets  : 0                  Discarded Packets  : 0
Forwarded Octets   : 0                  RPF Mismatches     : 0
-------------------------------------------------------------------------------
Groups : 1
===============================================================================
Table 16:  Show PIM Group Output Fields 

Label

Description

Group Address

The IP multicast group address for which this entry contains information

Source Address

The source address of the multicast sender

RP Address

Always set to 0 (zero)

Flags

The lists to which this interface belongs

Type

The type of entry: (*,*, rp)/(*,G) or (S,G)

The 7705 SAR only supports and will only indicate (S,G)

Spt Bit

Specifies whether to forward on (*,*, rp)/(*,G) or on (S,G) state. It is updated when the (S,G) data comes on the RPF interface towards the source.

The 7705 SAR only supports and will only indicate (S,G)

Inc Intf

The incoming interface on which the traffic arrives (that is, the RPF interface to the source)

No. Oifs

The number of interfaces in the inherited outgoing interface list, where an inherited list inherits the state from other types

MRIB Next Hop

The next-hop address towards the source

MRIB Src Flags

The MRIB information about the source

Keepalive Timer

The keepalive timer is applicable only for (S,G) entries

The (S,G) keepalive timer is updated by data being forwarded using this (S,G) Forwarding state. It is used to keep the (S,G) state alive in the absence of explicit (S,G) joins.

Up Time

The length of time since this source group entry was created

Resolved By

The route table used for the RPF check

Up JP State

The upstream Join Prune state for this entry on the interface. PIM Join Prune messages are sent by the downstream routers towards the RPF neighbor.

Up JP Expiry

The minimum amount of time remaining before this entry will be aged out

Up JP Rpt

The Join Prune Rpt state for this entry on the interface. PIM Join Prune messages are sent by the downstream routers towards the RPF neighbor. The (S,G, rpt) state is a result of receiving an (S,G, rpt) JP message from the downstream router on the source tree.

Up JP Rpt Override

The value used to delay triggered Join (S,G, rpt) messages to prevent implosions of triggered messages

If this has a non-zero value, it means that the router was in a “notPruned”state and it saw a prune (S,G, rpt) message being sent to the RPF (S,G, rpt). If the router sees a join (S,G, rpt) override message being sent by some other router on the LAN while the timer is still non-zero, it simply cancels the override timer. If it does not see a join (S,G, rpt) message, then on expiry of the override timer, it sends its own join (S,G, rpt) message to the RPF (S,G, rpt).

Register State

The register state: always displays “No info”

Register Stop Exp

The time remaining before the register state might transition to a different state

Reg from Anycast RP

The receive status of the Register packet for that group from one of the RPs from the anycast-RP set: always displays “No”

RPF Neighbor

The address of the Reverse Path Forwarding (RPF) neighbor

Outgoing Intf List

A list of interfaces on which data is forwarded

Curr Fwding Rate

The current forwarding rate of the multicast data for this group and source

Forwarded Packets

The number of multicast packets that were forwarded to the interfaces in the outgoing interface list

Discarded Packets

The number of multicast packets that matched this source group entry but were discarded

For (S,G) entries, if the traffic is getting forwarded on the SPT (Shortest Path Tree), the packets arriving from the RPT will be discarded

Forwarded Octets

The number of octets forwarded

RPF Mismatches

The number of multicast packets that matched this source group entry but they did not arrive on the interface

Spt threshold

The value of the SPT threshold configured for that group: 0 kbps means that the switch to the SP tree will happen immediately

interface

Syntax 
interface [ip-int-name | int-ip-address] [group grp-ip-address] [source ip-address] [detail] [family]
Context 
show>router>pim
Description 

This command displays PIM interface information and the (S,G) state of the interface.

Parameters 
ip-int-name—
displays the interface information associated with the specified IP interface name
ip-address—
displays the interface information associated with the specified IP address
grp-ip-address—
the IP multicast group address for which this entry contains information
source ip-address
specifies the source address for which this entry contains information
detail—
displays detailed interface information
family—
displays IPv4 or IPv6 information for the interface
Values—
ipv4 or ipv6

 

Output 

The following output is an example of PIM interface information, and Table 17 describes the fields.

Output Example
*A:7705:Dut-A# show router pim interface    
==================================================================
PIM Interfaces ipv4
==================================================================
Interface                   Adm  Opr  DR Prty         Hello Intvl              
   DR                                                                          
------------------------------------------------------------------
ip-10.1.7.1                 Up   Up   1               30          
   10.1.7.7
ip-100.111.1.1              Up   Up   1               30          
   100.111.1.1
------------------------------------------------------------------
Interfaces : 2
==================================================================
*A:7705:Dut-A# show router pim interface detail  
===============================================================================
PIM Interface ipv4 ip-10.1.7.1
===============================================================================
Admin Status       : Up                 Oper Status        : Up
IPv4 Admin Status  : Up                 IPv4 Oper Status   : Up
DR                 : 10.1.7.7
Oper DR Priority   : 1                  
BSM RA Check       : Disabled           Cfg DR Priority    : 1
Hello Interval     : 30                 Time for next hello: 0d 00:00:16
Hello Multiplier   : 35                 
J/P Tracking Admin : Disabled           J/P Tracking Oper  : Disabled
Auto-created       : No                 Improved Assert    : Enabled
Sticky-DR          : Disabled           Sticky-DR Priority : N/A
Max Groups Allowed : 0                  Max Groups Till Now: 5
Num Groups         : 5                  Bfd enabled        : No
Three-way Hello    : Disabled           Assert-Period      : 60
Instant Prune Echo : Disabled           
-------------------------------------------------------------------------------
PIM Group Source
-------------------------------------------------------------------------------
Group Address      : 232.0.0.0        
Source Address     : 100.111.1.2
Interface          : ip-10.1.7.1        Type               : (S,G)
RP Address         : 0.0.0.0            
Up Time            : 0d 00:01:09        
 
Join Prune State   : Join               Expires            : 0d 00:03:21
Prune Pend Expires : N/A                
 
Assert State       : No Info            
-------------------------------------------------------------------------------
PIM Group Source
-------------------------------------------------------------------------------
Group Address      : 232.0.0.1
Source Address     : 100.111.1.2
Interface          : ip-10.1.7.1        Type               : (S,G)
RP Address         : 0.0.0.0            
Up Time            : 0d 00:01:10        
 
Join Prune State   : Join               Expires            : 0d 00:03:20
Prune Pend Expires : N/A                
 
Assert State       : No Info            
-------------------------------------------------------------------------------
PIM Group Source
-------------------------------------------------------------------------------
Group Address      : 232.0.0.2
Source Address     : 100.111.1.2
Interface          : ip-10.1.7.1        Type               : (S,G)
RP Address         : 0.0.0.0            
Up Time            : 0d 00:01:11        
 
Join Prune State   : Join               Expires            : 0d 00:03:19
Prune Pend Expires : N/A                
 
Assert State       : No Info            
-------------------------------------------------------------------------------
PIM Group Source
-------------------------------------------------------------------------------
Group Address      : 232.0.0.3
Source Address     : 100.111.1.2
Interface          : ip-10.1.7.1        Type               : (S,G)
RP Address         : 0.0.0.0            
Up Time            : 0d 00:01:11        
                                      
Join Prune State   : Join               Expires            : 0d 00:03:19
Prune Pend Expires : N/A                
 
Assert State       : No Info            
-------------------------------------------------------------------------------
PIM Group Source
-------------------------------------------------------------------------------
Group Address      : 232.0.0.4
Source Address     : 100.111.1.2
Interface          : ip-10.1.7.1        Type               : (S,G)
RP Address         : 0.0.0.0            
Up Time            : 0d 00:01:11        
 
Join Prune State   : Join               Expires            : 0d 00:03:18
Prune Pend Expires : N/A                
 
Assert State       : No Info            
===============================================================================
PIM Interface ipv4 ip-100.111.1.1
===============================================================================
Admin Status       : Up                 Oper Status        : Up
IPv4 Admin Status  : Up                 IPv4 Oper Status   : Up
DR                 : 100.111.1.1
Oper DR Priority   : 1                  
BSM RA Check       : Disabled           Cfg DR Priority    : 1
Hello Interval     : 30                 Time for next hello: 0d 00:00:29
Hello Multiplier   : 35                 
J/P Tracking Admin : Disabled           J/P Tracking Oper  : Disabled
Auto-created       : No                 Improved Assert    : Enabled
Sticky-DR          : Disabled           Sticky-DR Priority : N/A
Max Groups Allowed : 0                  Max Groups Till Now: 0
Num Groups         : 0                  Bfd enabled        : No
Three-way Hello    : Disabled           Assert-Period      : 60
Instant Prune Echo : Disabled           
-------------------------------------------------------------------------------
Interfaces : 2
===============================================================================
*A:7705:Dut-A# show router pim interface group 
==================================================================
PIM Interface ipv4 ip-10.1.7.1
==================================================================
Interface                   Adm  Opr  DR Prty         Hello Intvl              
   DR                                                                          
------------------------------------------------------------------
ip-10.1.7.1                 Up   Up   1               30          
   10.1.7.7
-------------------------------------------------------------------------------
Group Address                                Type     JP            Assert    
   Source Address                                                             
   RP Address                                                                 
-------------------------------------------------------------------------------
232.0.0.0                                    (S,G)    Join          No Info    
   100.111.1.2
   
232.0.0.1                                    (S,G)    Join          No Info    
   100.111.1.2
   
232.0.0.2                                    (S,G)    Join          No Info    
   100.111.1.2
   
232.0.0.3                                    (S,G)    Join          No Info    
   100.111.1.2
   
232.0.0.4                                    (S,G)    Join          No Info    
   100.111.1.2
------------------------------------------------------------------
Interfaces : 1
==================================================================
*A:7705:Dut-A# show router pim interface group 232.0.0.0 detail 
==================================================================
PIM Interface ipv4 ip-10.1.7.1
==================================================================
Interface                   Adm  Opr  DR Prty         Hello Intvl              
   DR                                                                          
------------------------------------------------------------------
ip-10.1.7.1                 Up   Up   1               30          
   10.1.7.7
-------------------------------------------------------------------------------
PIM Group Source
-------------------------------------------------------------------------------
Group Address      : 232.0.0.0
Source Address     : 100.111.1.2
Interface          : ip-10.1.7.1        Type               : (S,G)
RP Address         : 0.0.0.0            
Up Time            : 0d 00:11:09        
 
Join Prune State   : Join               Expires            : 0d 00:03:21
Prune Pend Expires : N/A                
 
Assert State       : No Info            
------------------------------------------------------------------
Interfaces : 1
==================================================================
Table 17:  Show PIM Interface Output Fields 

Label

Description

PIM Interface

Admin Status

The administrative state for the PIM protocol on this interface

Oper Status

The current operational state of the PIM protocol on this interface

IPv4 Admin Status

The administrative state for the PIM protocol on this interface

IPv4 Oper Status

The current operational state of the PIM protocol on this interface

DR

The designated router on this PIM interface

Oper DR Priority

The priority of the operational designated router

BSM RA Check

Not applicable

Cfg DR Priority

The priority value sent in PIM Hello messages that is used by routers to elect the designated router (DR)

Hello Interval

The time interval at which PIM Hello messages are transmitted on this interface

Time for next hello

The time when the next PIM Hello message will be transmitted

Hello Multiplier

The value of the hello multiplier

J/P Tracking Admin

The administrative state for Join Prune message tracking: Enabled or Disabled

J/P Tracking Oper

The operational state for Join Prune message tracking: Enabled or Disabled

Auto-created

Specifies whether the PIM interface was auto-created: Yes or No

Improved Assert

Specifies whether the improved assert processing on this interface is Enabled or Disabled. The 7705 SAR supports only Enabled (that is, the PIM assert process is done entirely on the control plane with no interaction between the control and forwarding planes).

Sticky-DR

The configured state of sticky-DR: Enabled or Disabled

Sticky-DR Priority

Not applicable

Max Groups Allowed

The maximum number of groups allowed for this interface

Max Groups Till Now

The maximum number of groups joined for this interface up until the present time

Num Groups

The current number of groups joined for this interface

Bfd enabled

Specifies whether BFD is enabled: Yes or No

Three-way Hello

The state of the three-way hello parameter: Enabled or Disabled

Assert-Period

The period for refreshes of PIM Assert messages on an interface

Instant Prune Echo

The state of the instant prune echo: Enabled or Disabled

PIM Group Source

Group Address

The group IP address for this PIM group

Source Address

The unicast source IP address for this PIM group

Interface

The PIM IP address for this PIM interface

Type

The type of multicast group

RP Address

The IP address of the Rendezvous Point for this PIM interface

Up Time

The time since this PIM interface joined the multicast group

Join Prune State

The Join Prune state for this PIM interface and multicast group

Expires

The length of time until this PIM interface leaves the multicast group

Prune Pend Expires

Not applicable

Assert State

The PIM assert message state

neighbor

Syntax 
neighbor [ip-int-name | ip-address [address neighbor-ip-address]] [detail] [family]
Context 
show>router>pim
Description 

This command displays PIM neighbor information.

This information can be important if an interface has more than one adjacency. For example, assume a LAN interface configuration has three routers connected and all the routers are running PIM on their LAN interfaces. These routers have two adjacencies on their LAN interface, each with different neighbors. If the address neighbor-ip-address parameter is not defined in this example, then the show command output would display two adjacencies instead of only the one adjacency of the neighbor whose IP address is specified.

Parameters 
ip-int-name—
displays the interface information associated with the specified IP interface name
ip-address—
displays the interface information associated with the specified IP address (IPv4 or IPv6)
neighbor-ip-address—
the IP address of the PIM neighbor on the other side of the interface (IPv4 or IPv6)
detail—
displays detailed interface information
family—
displays IPv4 or IPv6 information for the interface
Values—
ipv4 or ipv6

 

Output 

The following output is an example of PIM neighbor information, and Table 18 describes the fields.

Output Example
*A:7705custDoc:Sar18>show>router>pim# neighbor
===============================================================================
PIM Neighbor ipv4
===============================================================================
Interface               Nbr DR Prty     Up Time       Expiry Time     Hold Time
   Nbr Address
-------------------------------------------------------------------------------
ip-10.1.7.7             1               0d 00:29:49   0d 00:01:28     105      
   10.1.7.1
ip-100.112.1.1          0               0d 00:28:44   0d 00:00:05     5        
   100.112.1.2
ip-100.112.2.1          0               0d 00:28:44   0d 00:00:05     5        
   100.112.2.2
ip-100.112.3.1          0               0d 00:28:43   0d 00:00:04     5        
   100.112.3.2
ip-100.112.4.1          0               0d 00:28:43   0d 00:00:03     5        
   100.112.4.2
-------------------------------------------------------------------------------
Neighbors : 5
===============================================================================
*A:7705custDoc:Sar18>show>router>pim# neighbor
*A:7CSA:Dut-C# show router pim neighbor ip-10.1.7.7 
===============================================================================
PIM Neighbor ipv4
===============================================================================
Interface               Nbr DR Prty     Up Time       Expiry Time     Hold Time
   Nbr Address                                                                 
-------------------------------------------------------------------------------
ip-10.1.7.7             1               0d 00:58:15   0d 00:01:31     105      
   10.1.7.1
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
*A:7CSA:Dut-C# show router pim neighbor ip-10.1.7.7 detail        
===============================================================================
PIM Neighbor ipv4
===============================================================================
Interface          : ip-10.1.7.7
Neighbor Addr      : 10.1.7.1
DR Priority        : 1                  
Tracking Support   : No                 LAN Delay(ms)      : 500
Gen Id             : 60143787           Override Intvl(ms) : 2500
Up Time            : 0d 01:00:13        Expiry Time        : 0d 00:01:34
Hold Time(sec)     : 105                
 
-------------------------------------------------------------------------------
Secondary Neighbor Addresses
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
Table 18:  Show PIM Neighbor Output Fields 

Label

Description

Interface

The interface name of the neighbor

Nbr DR Priority

The value of the DR priority of the neighbor, which is received in the Hello message

Nbr Address

The IP address of the neighbor

Up Time

The time since this PIM neighbor (last) became a neighbor of the local router

Expiry Time

The minimum time remaining before this PIM neighbor will be aged out

A value of 0 (zero) means that this neighbor will never be aged out, which occurs when the PIM neighbor sends a Hello message with hold time set to 0xffff

Hold Time

The value of the hold time present in the Hello message

DR Priority

The value of the DR priority of the neighbor, which is received in the Hello message

Tracking Support

Indicates the presence of the T-bit in the LAN prune delay option in the Hello message: Yes or No, which indicates the neighbor's capability to disable join message suppression

LAN Delay (ms)

The value of the LAN delay field present in the Hello message received from the neighbor

Gen Id

A randomly generated 32-bit value that is regenerated each time PIM forwarding is started or restarted on the interface, including when the router itself restarts. When a Hello message with a new GenID is received from a neighbor, any old Hello information about that neighbor is discarded and superseded by the information from the new Hello message.

Override Intvl (ms)

The value of the override interval present in the Hello message

rp

Syntax 
rp [family | ip-address]
Context 
show>router>pim
Description 

This command displays RP information that is learned through PIM bootstrap or configured statically.

Parameters 
family—
displays either IPv4 or IPv6 information
Values—
ipv4 or ipv6

 

Default—
ipv4
ip-address—
displays RP information associated with the specified IP address
Output 

The following output is an example of RP output information, and Table 19 describes the fields.

Output Example
*A:Sar18 Dut-B>show>router>pim# rp
===============================================================================
PIM RP Set ipv4
===============================================================================
Group Address                                                Hold Expiry
  RP Address                                   Type     Prio Time Time
-------------------------------------------------------------------------------
224.0.0.0/4                                                                   
  200.200.200.4                                Dynamic  192  150   N/A        
  10.1.7.1                                     Static   1    N/A   N/A        
===============================================================================
Table 19:  Show RP Output Fields 

Label

Description

Group Address

The multicast group address of the entry

RP Address

The IP address of the RP

Type

Indicates whether the entry was learned through the bootstrap mechanism or was statically configured

Prio

The priority for the specified group address. The higher the value, the higher the priority

Hold Time

The value of the hold time present in the BSM message

Expiry Time

The length of time until the entry expires

rp-hash

Syntax 
rp-hash ip-address
Context 
show>router>pim
Description 

This command hashes the RP for the multicast group address associated with the specified IPv4 address.

Parameters 
ip-address—
displays RP information for the multicast group associated with the specified IPv4 address
Output 

The following output is an example of RP hash output information, and Table 20 describes the fields.

Output Example
*A:Sar18 Dut-B>show>router>pim# rp-hash 10.10.10.10 
===============================================================================
PIM RP Set ipv4
===============================================================================
Group Address                                       Type         
  RP Address                                             
-------------------------------------------------------------------------------
228.101.0.0                                         Bootstrap
  200.200.200.4                                            
===============================================================================
Table 20:  Show RP Hash Output Fields 

Label

Description

Group Address

The multicast group address for the specified IP address

RP Address

The IP address of the RP

Type

Indicates whether the entry was learned through the bootstrap mechanism or was statically configured

s-pmsi

Syntax 
s-pmsi [detail]
s-pmsi [mdSrcAddr [mdGrpAddr]] [detail]
s-pmsi ext-tunnel-id ext-tunnel-id [tunnel-id tunnel-id] [detail]
s-pmsi root-addr root-addr [lsp-id lsp-id] [detail]
Context 
show>router>pim
Description 

This command displays PIM S-PMSIs that are currently active.

Parameters 
detail—
displays detailed information
mdSrcAddr—
displays PIM S-PMSI information associated with the specified source address of the multicast sender
mdGrpAddr—
displays PIM S-PMSI information associated with the specified group address of the multicast sender
ext-tunnel-id—
displays PIM S-PMSI information associated with the specified external tunnel ID
tunnel-id—
displays PIM S-PMSI information associated with the specified tunnel ID
root-addr—
displays PIM S-PMSI information associated with the specified root address
Output 

The following output is an example of S-PMSI output information, and Table 21 describes the fields.

Output Example
*B:node-6# show router 100 pim s-pmsi
===============================================================================
PIM Selective provider tunnels
===============================================================================
MD Src Address        MD Grp Address        MT Index      Num VPN SGs         
-------------------------------------------------------------------------------
200.200.200.7         230.0.89.72           24603         1                   
200.200.200.7         230.0.89.73           24604         1                   
200.200.200.7         230.0.89.74           24605         1                   
200.200.200.7         230.0.89.75           24606         1                   
200.200.200.7         230.0.89.76           24607         1                   
200.200.200.7         230.0.89.77           24608         1                   
200.200.200.7         230.0.89.78           24609         1                   
200.200.200.7         230.0.89.79           24610         1                   
200.200.200.7         230.0.89.80           24611         1                   
200.200.200.7         230.0.89.81           24612         1                   
200.200.200.7         230.0.89.82           24613         1                   
200.200.200.7         230.0.89.83           24614         1                   
200.200.200.7         230.0.89.84           24615         1                   
200.200.200.7         230.0.89.85           24616         1                   
200.200.200.7         230.0.89.86           24617         1                   
200.200.200.7         230.0.89.87           24618         1
...
===============================================================================
*B:node-6# 
 
*B:node-6# show router 100 pim s-pmsi detail
===============================================================================
PIM Selective provider tunnels
===============================================================================
Md Source Address  : 200.200.200.7      Md Group Address   : 230.0.89.72      
Number of VPN SGs  : 1                  Uptime             : 0d 00:00:18      
MT IfIndex         : 24603              Egress Fwding Rate : 163.2 kbps       
 
VPN Group Address  : 228.1.0.0          VPN Source Address : 11.2.102.1       
State              : RX Joined                                                
Expiry Timer       : 0d 00:02:41 
===============================================================================
PIM Selective provider tunnels
===============================================================================
Md Source Address  : 200.200.200.7      Md Group Address   : 230.0.89.73      
Number of VPN SGs  : 1                  Uptime             : 0d 00:00:18      
MT IfIndex         : 24604              Egress Fwding Rate : 163.2 kbps       
 
VPN Group Address  : 228.1.0.1          VPN Source Address : 11.2.102.1       
State              : RX Joined                                                
Expiry Timer       : 0d 00:02:41 
===============================================================================
PIM Selective provider tunnels
===============================================================================
Md Source Address  : 200.200.200.7      Md Group Address   : 230.0.89.74      
Number of VPN SGs  : 1                  Uptime             : 0d 00:00:20      
MT IfIndex         : 24605              Egress Fwding Rate : 165.7 kbps       
 
VPN Group Address  : 228.1.0.2          VPN Source Address : 11.2.102.1       
State              : RX Joined                                                
Expiry Timer       : 0d 00:02:39 
===============================================================================
PIM Selective provider tunnels
===============================================================================
Md Source Address  : 200.200.200.7      Md Group Address   : 230.0.89.75      
Number of VPN SGs  : 1                  Uptime             : 0d 00:00:20      
MT IfIndex         : 24606              Egress Fwding Rate : 165.7 kbps       
 
VPN Group Address  : 228.1.0.3          VPN Source Address : 11.2.102.1       
State              : RX Joined                                                
Expiry Timer       : 0d 00:02:39                                              
===============================================================================
*B:node-6# 
Table 21:  Show S-PMSI Output Fields 

Label

Description

MD Grp Address

The IP multicast group address for which this entry contains information

MD Src Address

The source address of the multicast sender

A value of 0 (zero) indicates that the type is configured as starg.

MT Index

MT IfIndex

Displays the index number

Num VP SGs

Displays the number of VPN (S,G)s

Uptime

The length of time that the S-PMSI has been up

Egress Fwding Rate

he egress forwarding rate for the S-PMSI

VPN Group Address

The VPN group address for the S-PMSI

VPN Source Address

The VPN source address for the S-PMSI

Expiry Timer

The minimum time remaining before this S_PMSI will be aged out

A value of 0 (zero) means that this S-PMSI will never be aged out, which occurs when the PIM neighbor sends a Hello message with hold time set to 0xffff

statistics

Syntax 
statistics [ip-int-name | ip-address] [family]
Context 
show>router>pim
Description 

This command displays statistics for a particular PIM instance.

Parameters 
ip-int-name—
displays the interface information associated with the specified IP interface name
ip-address—
displays the interface information associated with the specified IP address
family—
displays either IPv4 or IPv6 information
Values—
ipv4 or ipv6

 

Output 

The following output is an example of PIM statistics output information, and Table 22 describes the fields.

Output Example
*A:7CSA:Dut-C# show router pim statistics 
================================================================
PIM Statistics ipv4
================================================================
Message Type        Received       Transmitted    Rx Errors                    
----------------------------------------------------------------
Hello               25435          2907           0             
Join Prune          75796          79             0             
Asserts             0              0              0             
Register            0              0              0             
Null Register       0              0              0             
Register Stop       0              0              0             
BSM                 0              0              0             
Candidate RP Adv    0              0              0             
Total Packets       101231         2986                         
-------------------------------------------------------------------------------
General Statistics
-------------------------------------------------------------------------------
Rx Invalid Register               : 0
Rx Neighbor Unknown               : 0
Rx Bad Checksum Discard           : 0
Rx Bad Encoding                   : 0
Rx Bad Version Discard            : 0
Rx CRP No Router Alert            : 0
Rx BSM Router Alert Drops         : 0
Rx BSM Wrong If Drops             : 0
Rx Invalid Join Prune             : 0
Rx Unknown PDU Type               : 0
Join Policy Drops                 : 0
Register Policy Drops             : 0
Bootstrap Import Policy Drops     : 0
Bootstrap Export Policy Drops     : 0
Fwd Candidate RP Adv              : 0
Fwd Candidate RP Adv Drops        : 0
-------------------------------------------------------------------------------
Source Group Statistics
-------------------------------------------------------------------------------
(S,G)                             : 64
(*,G)                             : 0
(*,*,RP)                          : 0
================================================================
Table 22:  Show PIM Statistics Output Fields 

Label

Description

PIM Statistics

Message Type

Hello — the number of PIM Hello messages received or transmitted on this interface

Join Prune — the number of PIM Join Prune messages received or transmitted on this interface

Asserts — the number of PIM Assert messages received or transmitted on this interface

Register — the number of Register messages received or transmitted on this interface

Null Register — the number of PIM Null Register messages received or transmitted on this interface

Register Stop — the number of PIM Register Stop messages received or transmitted on this interface

BSM — the number of PIM Bootstrap messages (BSM) received or transmitted on this interface

Candidate RP Adv — the number of candidate RP advertisements

Total Packets — the total number of packets transmitted and received on this interface

Received

The number of messages received on this interface

Transmitted

The number of multicast data packets transmitted on this interface

Rx Errors

The total number of receive errors

General Statistics

Rx Invalid Register

The number of invalid PIM Register messages received on this interface

Rx Neighbor Unknown

The number of PIM messages (other than Hello messages) that were received on this interface and were rejected because the adjacency with the neighbor router was not already established

Rx Bad Checksum Discard

The number of PIM messages received on this interface that were discarded because of a bad checksum

Rx Bad Encoding

The number of PIM messages with bad encodings received on this interface

Rx Bad Version Discard

The number of PIM messages with bad versions received on this interface

Rx CRP No Router Alert

The number of candidate-rp advertisements (C-RP-Adv) received on this interface that had no router alert option set

Rx BSM Router Alert Drops

The number of router alert bootstrap message alerts that have been dropped on this interface

Rx BSM Wrong If Drops

The number of bootstrap messages not meant to be received on this interface

Rx Invalid Join Prune

The number of invalid PIM Join Prune messages received on this interface

Rx Unknown PDU Type

The number of packets received with an unsupported PIM type

Join Policy Drops

The number of times the join policy match resulted in dropping a PIM Join Prune message or one of the source groups contained in the message

Register Policy Drops

The number of times the register policy match resulted in dropping a PIM Register message

Bootstrap Import Policy Drops

The number of Bootstrap messages received on this interface that were dropped because of Bootstrap import policy

Bootstrap Export Policy Drops

The number of Bootstrap messages that were not transmitted on this interface because of Bootstrap export policy

Fwd Candidate RP Adv

The number of candidate RP advertisements that were forwarded by the router

Fwd Candidate RP Adv Drops

The number of candidate RP advertisements that were dropped by the router

Source Group Statistics

(S,G)

The number of entries in which the type is (S,G)

(*,G)

The number of entries in which the type is (*,G)

(*,*,RP)

The number of entries in which the type is (*, *, rp)

status

Syntax 
status [detail] [family]
Context 
show>router>pim
Description 

This command displays the PIM status. The Oper Status indicates the combined operational status of IPv4/IPv6 PIM protocol status. If both are down, then Oper Status will be shown as down. If IPv4 or IPv6 is up, the Oper Status will indicate up.

If PIM is not enabled, the following message appears:

A:NYC# show router pim status
MINOR: CLI PIM is not configured.
A:NYC#
Parameters 
family—
displays either IPv4 or IPv6 information
Values—
ipv4 or ipv6

 

detail—
displays detailed status information
Output 

The following output is an example of PIM status information, and Table 23 describes the fields.

Output Example
*A:7705:Dut-A# show router pim status detail ipv4 
===============================================================================
PIM Status ipv4
===============================================================================
Admin State                       : Up
Oper State                        : Up
 
IPv4 Admin State                  : Up
IPv4 Oper State                   : Up
 
BSR State                         : Accept Any
 
Elected BSR
    Address                       : None
    Expiry Time                   : N/A
    Priority                      : N/A
    Hash Mask Length              : 30
    Up Time                       : N/A
    RPF Intf towards E-BSR        : N/A
 
Policy                            : None
                                      
RPF Table                         : rtable-u
 
Non-DR-Attract-Traffic            : Disabled
===============================================================================
*A:7705:Dut-A# show router pim status detail ipv6 
===============================================================================
PIM Status ipv6
===============================================================================
Admin State                       : Up
Oper State                        : Up
 
IPv6 Admin State                  : Down
IPv6 Oper State                   : Down
 
BSR State                         : Accept Any
 
Elected BSR
    Address                       : None
    Expiry Time                   : N/A
    Priority                      : N/A
    Hash Mask Length              : 126
    Up Time                       : N/A
    RPF Intf towards E-BSR        : N/A
 
Policy                            : None
                                      
RPF Table                         : rtable6-u
 
Non-DR-Attract-Traffic            : Disabled
===============================================================================
Table 23:  Show PIM Status Output Fields 

Label

Description

Admin State

The administrative status of PIM

Oper State

The current operating state of this PIM protocol instance

IPv4 Admin State

IPv6 Admin State

The administrative status of PIM

IPv4 Oper State

IPv6 Oper State

The current operating state of this PIM protocol instance

BSR State

The state of the router with respect to the Bootstrap mechanism

Elected BSR

Address — the address of the elected Bootstrap router

Expiry Time — the time remaining before the router sends the next Bootstrap message

Priority — the priority of the elected Bootstrap router. The higher the value, the higher the priority.

Hash Mask Length — the hash mask length of the Bootstrap router

Up Time — the time since the current E-BSR became the Bootstrap router

RPF Intf towards E-BSR — the RPF interface towards the elected BSR. The value is zero if there is no elected BSR in the network.

Policy

The PIM policies for a particular PIM instance

RPF Table

The route table used for the RPF check

Non-DR-Attract-Traffic

Indicates whether the router ignores the designated router state and attracts traffic even when it is not the designated router

msdp

Syntax 
msdp
Context 
show>router
Description 

This command enables the context to display MSDP information.

group

Syntax 
group [group-name] [detail]
Context 
show>router>msdp
Description 

This command displays information about MSDP groups.

Parameters 
group-name—
displays information about the specified group name. If no group-name is specified, information about all group names display.
detail—
displays detailed MSDP group information
Output 

The following output is an example of MSDP group information, and Table 24 describes the fields.

Output Example
*A:ALA-48>show>router>msdp# group
===============================================================================
MSDP Groups
===============================================================================
Group Name                        Mode        Act Srcs  Local Address          
-------------------------------------------------------------------------------
main                              Mesh-group  None      None       
loop1                             Mesh-group  None      None                   
loop2                             Mesh-group  None      None                   
loop3                             Mesh-group  None      None                   
loop4                             Mesh-group  None      None                   
loop5                             Mesh-group  None      None                   
-------------------------------------------------------------------------------
Groups : 6
=======================
*A:ALA-48>show>router>msdp# 
 
 
*A:ALA-48>show>router>msdp# group test
===============================================================================
MSDP Groups
===============================================================================
Group Name                        Mode       Act Srcs  Local Address
-------------------------------------------------------------------------------
test                              Mesh-group 50000     10.10.10.103
-------------------------------------------------------------------------------
Groups : 1
===============================================================================
*A:ALA-48>show>router>msdp#
 
 
*A:ALA-48>show>router>msdp# group test detail
===============================================================================
MSDP Groups
===============================================================================
Group Name         : test
-------------------------------------------------------------------------------
Local Address      : 10.10.10.103
Admin State        : Up                 Receive Msg Rate   : None
Receive Msg Time   : None               Receive Msg Thd    : None
Mode               : Mesh-group         SA Limit           : 50000
Export Policy      : None Specified / Inherited
Import Policy      : None Specified / Inherited
 
-------------------------------------------------------------------------------
Groups : 1
===============================================================================
*A:ALA-48>show>router>msdp#
Table 24:  Show MSDP Group Output Fields 

Label

Description

Group Name

Displays the MSDP group name

Mode

Displays the groups of peers in a full mesh topology to limit excessive flooding of source-active messages to neighboring peers

Act Srcs

Displays the configured maximum number of active source messages that will be accepted by MSDP

Local Address

Displays the local end of a MSDP session

Admin State

Displays the administrative state

Receive Msg Rate

Displays rate that the messages are read from the TCP session

Receive Msg Time

Displays the time of MSDP messages that are read from the TCP session within the configured number of seconds

Receive Msg Thd

Displays the configured threshold number of MSDP messages that can be processed before the MSDP message rate limiting function

SA Limit

Displays the source-active limit

peer

Syntax 
peer [ip-address] [group group-name] [detail]
Context 
show>router>msdp
Description 

This command displays information about an MSDP peer.

Parameters 
ip-address—
displays information about the specified IP address. If no IP address specified, information about all MSDP IP addresses display.
group-name—
displays information about the specified group name. If no group-name is specified, information about all MSDP peers display.
detail—
displays detailed MSDP peer information
Output 

The following output is an example of MSDP peer information, and Table 25 describes the fields.

Output Example
A:ALA-48# show router msdp peer
=============================================================================
MSDP Peers
=============================================================================
Peer             Local Address    State       Last State Change     SA Learnt
-----------------------------------------------------------------------------
10.20.1.1        10.20.1.6        Established 08/30/2002 03:22:13   1008    
-----------------------------------------------------------------------------
Peers : 1
=============================================================================
A:ALA-48# 
 
 
A:ALA-48# show router msdp peer detail
===============================================================================
MSDP Peers
-------------------------------------------------------------------------------
Peer Address       : 10.20.1.1                                                
-------------------------------------------------------------------------------
Group Name         : None                                                     
Local Address      : 10.20.1.6                                                
Last State Change  : 08/30/2002 03:22:13 Last Act Src Limit : N/A
Peer Admin State   : Up                 Default Peer       : No               
Peer Connect Retry : 0                  State              : Established      
SA accepted        : 1008               SA received        : 709              
State timer expires: 18                 Peer time out      : 62               
Active Source Limit: None               Receive Msg Rate   : 0                
Receive Msg Time   : 0                  Receive Msg Thd    : 0                
Auth Status        : Disabled           Auth Key           : None             
Export Policy      : None Specified / Inherited
Import Policy      : None Specified / Inherited
-------------------------------------------------------------------------------
Peers : 1
===============================================================================
A:ALA-48#
Table 25:  Show MSDP Peer Output Fields 

Label

Description

Peer

Displays the IP address of the peer

Local Address

Displays the local IP address

State

Displays the current state of the peer

Last State Change

Displays the date and time of the peer’s last state change

SA Learnt

The number of SAs learned through a peer

source

Syntax 
source [ip-address/mask] [type {configured | dynamic | both}] [detail]
Context 
show>router>msdp
Description 

This command displays the discovery method for this multicast source.

Parameters 
configured—
displays user-created sources
dynamic—
displays dynamically created sources
both—
displays both user-configured and dynamically created sources
detail—
displays detailed MSDP source information

source-active

Syntax 
source-active [{group ip-address | local | originator ip-address | peer ip-address | source ip-address | group ip-address source ip-address}] [detail]
Context 
show>router>msdp
Description 

This command displays source-active messages accepted by MSDP

Parameters 
group ip-address
displays information about the specified group IP address
local—
displays information about local source-active messages
originator ip-address
displays information about the specified originator IP address
peer ip-address
displays information about the specified peer IP address
source ip-address
displays information about the specified source IP address
group ip-address
displays information about the specified group IP address
detail—
displays detailed MSDP source-active information
Output 

The following output is an example of accepted MSDP source-active messages information, and Table 26 describes the fields.

Output Example
A:ALA-48# show router msdp source-active
===============================================================================
MSDP Source Active Info
===============================================================================
Grp Address      Src Address      Origin RP        Peer Address State Timer
-------------------------------------------------------------------------------
228.100.0.0      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.1      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.2      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.3      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.4      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.5      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.6      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.7      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.8      100.112.1.2      10.20.1.1        10.20.1.1    69        
228.100.0.9      100.112.1.2      10.20.1.1        10.20.1.1    69        
-------------------------------------------------------------------------------
MSDP Source Active : 10
===============================================================================
A:ALA-48# 
 
 
A:ALA-48# show router msdp source-active detail
===============================================================================
MSDP Source Active
===============================================================================
Group Address      : 228.100.0.0        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 3d 01:44:25      
Group Address      : 228.100.0.1        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.2        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.3        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.4        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.5        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.6        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.7        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.8        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 228.100.0.9        Source Address     : 100.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
-------------------------------------------------------------------------------
MSDP Source Active : 10
===============================================================================
A:ALA-48# 
Table 26:  Show MSDP Source-Active Output Fields 

Label

Description

Grp Address

Displays the IP address of the group

Src Address

Displays the IP address of the source

Origin RP

Displays the origination rendezvous point (RP) address

Peer Address

Displays the address of the peer

State Timer

Displays the state time-out value. If the value reaches zero, the SA entry is removed.

source-active-rejected

Syntax 
source-active-rejected [peer-group name] [group ip-address] [source ip-address] [originator ip-address] [peer ip-address]
Context 
show>router>msdp
Description 

This command displays source-active messages rejected by MSDP.

Parameters 
peer-group name
displays information about rejected source-active messages for the specified peer group
group ip-address
displays information about the specified group IP address
source ip-address
displays information about the source address of the source-active entry that is rejected
originator ip-address
displays information about the specified originator IP address
peer ip-address
displays information about the peer from which this rejected source-active entry was last received
Output 

The following output is an example of rejected MSDP source-active messages information, and Table 27 describes the fields.

Output Example
*A:ALA-48# show router msdp source-active-rejected
===============================================================================
MSDP Source Active Rejected Info
===============================================================================
Grp Address     Src Address     Origin RP       Peer Address    Reject Reason
-------------------------------------------------------------------------------
228.100.0.1     110.0.0.1       10.20.0.1       20.0.0.1        Import Policy
228.100.0.2     110.0.0.2       10.20.0.2       20.0.0.2        Export Policy
228.100.0.3     110.0.0.3       10.20.0.3       20.0.0.3        RPF Failure
228.100.0.4     110.0.0.4       10.20.0.4       20.0.0.4        Limit Exceeded
228.100.0.5     110.0.0.5       10.20.0.5       20.0.0.5        Limit Exceeded
228.100.0.6     110.0.0.6       10.20.0.6       20.0.0.6        Limit Exceeded
228.100.0.7     110.0.0.7       10.20.0.7       20.0.0.7        Limit Exceeded
-------------------------------------------------------------------------------
SA Rejected Entries : 7
===============================================================================
*A:ALA-48# 
Table 27:  Show MSDP Source-Active Output Fields 

Label

Description

Grp Address

Displays the IP address of the group

Src Address

Displays the IP address of the source

Origin RP

Displays the origination rendezvous point (RP) address

Peer Address

Displays the address of the peer

Reject Reason

Displays the reason why this source-active entry is rejected

statistics

Syntax 
statistics [peer ip-address]
Context 
show>router>msdp
Description 

This command displays statistics information related to a MSDP peer.

Parameters 
ip-address—
displays information about the specified peer IP address
Output 

The following output is an example of MSDP statistics information, and Table 28 describes the fields.

Output Example
A:ALA-48# show router msdp statistics
===============================================================================
MSDP Statistics
===============================================================================
Glo ActSrc Lim Excd: 0                                                        
-------------------------------------------------------------------------------
Peer Address       : 10.20.1.1                                                
-------------------------------------------------------------------------------
Last State Change  : 0d 11:33:16        Last message Peer  : 0d 00:00:17      
RPF Failures       : 0                  Remote Closes      : 0                
SA Msgs Sent       : 0                  SA Msgs Recvd      : 709              
SA req. Msgs Sent  : 0                  SA req. Msgs Recvd : 0                
SA res. Msgs Sent  : 0                  SA res. Msgs Recvd : 0                
KeepAlive Msgs Sent: 694                KeepAlive Msgs Recd: 694              
Unknown Msgs Sent  : 0                  Error Msgs Recvd   : 0                
-------------------------------------------------------------------------------
Peers : 1
===============================================================================
A:ALA-48#
Table 28:  Show MSDP Statistics Output Fields 

Label

Description

Last State Change

Displays the date and time the peer state changed

RPF Failures

Displays the number of reverse path forwarding (RPF) failures

SA Msgs Sent

Displays the number of source-active messages sent

SA req. Msgs Sent

Displays the number of source-active request messages sent

SA res. Msgs Sent

Displays the number of source-active response messages sent

KeepAlive Msgs Sent

Displays the number of keepalive messages sent

Unknown Msgs Sent

Displays the number of unknown messages received

Last message Peer

Displays the time the last message was received from the peer

Remote Closes

Displays the number of times the remote peer close

SA Msgs Recvd

Displays the number of source-active messages received

SA req. Msgs Recvd

Displays the number of source-active request messages received

SA res. Msgs Recvd

Displays the number of source-active response messages received

KeepAlive Msgs Recd

Displays the number of keepalive messages received

Error Msgs Recvd

Displays the number of unknown messages received

status

Syntax 
status
Context 
show>router>msdp
Description 

This command displays MSDP status information.

Output 

The following output is an example of MSDP status information, and Table 29 describes the fields.

Output Example
A:ALA-48# show router msdp status 
===============================================================================
MSDP Status
===============================================================================
Admin State                       : Up 
Local Address                     : None 
Global Statistics
Active Src Limit                  : None                                      
Act Src Lim Excd                  : 0                                         
Num. Peers                        : 1                                         
Num. Peers Estab                  : 1                                         
Num. Source Active                : 10 
Policies                          : None
Data Encapsulation                : Enabled 
Receive Msg Rate
Rate                              : 0                                         
Time                              : 0                                         
Threshold                         : 0 
Last Msdp Enabled                 : 08/30/2002 03:21:43
===============================================================================
A:ALA-48#
Table 29:  Show MSDP Status Output Fields 

Label

Description

Admin State

Displays the administrative state

Local Address

Displays the local IP address

Active Src Limit

Displays the active source limit

Act Src Lim Excd

Displays the active source limit which has been exceeded

Num. Peers

Displays the number of peers

Num. Peers Estab

Displays the number of peers established

Num. Source Active

Displays the number of active sources

Policies

The policy to export source-active state from the source-active list into MSDP

Data Encapsulation

The rendezvous point (RP) using MSDP to encapsulate multicast data received in MSDP register messages inside forwarded MSDP source-active messages: enabled or disabled

Rate

The receive message rate

Time

The receive message time

Threshold

The number of MSDP messages that can be processed before the MSDP message rate limiting function is activated

RPF Table

The name of the reverse path forwarding table

Last mdsp Enabled

The time the last MDSP was triggered

3.15.2.3. Clear Commands

igmp

Syntax 
igmp
Context 
clear>router
Description 

This command enables the context to clear and reset IGMP entities.

database

Syntax 
database [interface ip-int-name | ip-address] [group grp-ip-address [source src-ip-address]]
Context 
clear>router>igmp
Description 

This command clears IGMP database statistics on a specified interface or IP address.

Parameters 
ip-int-name—
clears the IGMP database on the specified interface
ip-address—
clears the IGMP database on the specified IP address
grp-ip-address—
clears the multicast group address (ipv4) or zero address in the specified address group
src-ip-address—
clears the IGMP database from the specified source IP address

statistics

Syntax 
statistics [ip-int-name | ip-address]
Context 
clear>router>igmp
Description 

This command clears IGMP statistics on a specified interface or IP address.

An interface and group/source cannot be specified at the same time.

Parameters 
ip-int-name—
clears IGMP statistics on the specified interface
ip-address—
clears IGMP statistics on the specified IP address

version

Syntax 
version [ip-int-name | ip-address]
Context 
clear>router>igmp
Description 

This command clears IGMP version parameters.

Parameters 
ip-int-name—
clears version information for the specified IGMP interface name
ip-address—
clears version information for the specified IGMP IP address

mld

Syntax 
mld
Context 
clear>router
Description 

This command enables the context to clear and reset MLD entities.

database

Syntax 
database [interface ip-int-name | ipv6-address] [group grp-ipv6-address [source src-ipv6-address]]
Context 
clear>router>mld
Description 

This command clears MLD database parameters.

Parameters 
ip-int-name—
clears database information for the specified MLD interface name
ipv6-address—
clears database information for the specified MLD interface IPv6 address
grp-ipv6-address—
clears database information for the specified MLD group IPv6 address
src-ipv6-address—
clears database information for the specified MLD source IP address

statistics

Syntax 
statistics [ip-int-name | ipv6-address]
Context 
clear>router>mld
Description 

This command clears MLD statistics parameters.

Parameters 
ip-int-name—
clears statistics for the specified MLD interface name
ipv6-address—
clears statistics for the specified MLD IPv6 address

version

Syntax 
version [ip-int-name | ip-address]
Context 
clear>router>mld
Description 

This command clears MLD version parameters.

Parameters 
ip-int-name—
clears version information for the specified MLD interface name
ip-address—
clears version information for the specified MLD IP address

pim

Syntax 
pim
Context 
clear>router
Description 

This command enables the context to clear and reset PIM entities.

database

Syntax 
database [interface ip-int-name | ip-address] [group grp-ip-address [source src-ip-address]] [family]
Context 
clear>router>pim
Description 

This command clears PIM database statistics on a specified interface or IP address.

Parameters 
ip-int-name—
clears the PIM database on the specified interface
ip-address—
clears the PIM database on the specified IP address
grp-ip-address—
clears the multicast group address (ipv4/ipv6) or zero address in the specified address group
src-ip-address—
clears the PIM database from the specified source IP address
family—
clears either IPv4 or IPv6 information
Values—
ipv4 or ipv6

 

neighbor

Syntax 
neighbor [ip-int-name] [family]
Context 
clear>router>pim
Description 

This command clears PIM neighbor data on a specified interface or IP address.

Parameters 
ip-int-name—
clears PIM neighbor data on the specified interface
family—
clears either IPv4 or IPv6 information. If family is not specified, both IPv4 and IPv6 data are cleared.
Values—
ipv4 or ipv6

 

statistics

Syntax 
statistics [family]
statistics interface ip-int-name | ip-address [family]
statistics group grp-ip-address [source ip-address] [family]
Context 
clear>router>pim
Description 

This command clears PIM statistics.

Parameters 
ip-int-name—
clears PIM statistics on the specified interface
interface ip-address
clears PIM statistics on the specified IP address
grp-ip-address—
specifies a multicast group address (IPv4 or IPv6 or zero address). When the group address is specified along with the source address, then the (S,G) statistics are reset to zero.
source ip-address
specifies a source or RP address (IPv4 or IPv6). When the source address is specified along with the group address, then the (S,G) statistics are reset to zero.
family—
clears either IPv4 or IPv6 information. If family is not specified, both IPv4 and IPv6 data are cleared.
Values—
ipv4 or ipv6

 

msdp

Syntax 
msdp
Context 
clear>router
Description 

This command enables the context to clear and reset Multicast Source Discovery protocol (MSDP) entities and statistics.

cache

Syntax 
cache [peer ip-address] [group ip-address] [source ip-address] [originrp ip-address]
Context 
clear>router>msdp
Description 

This command clears the MSDP cache.

Parameters 
peer ip-address
clears the cache of the IP address of the peer to which Multicast Source Discovery protocol (MSDP) source-active (SA) requests for groups matching this entry's group range were sent.
group ip-address
clears the group IP address of the SA entry
source ip-address
clears the source IP address of the SA entry
originrp ip-address
clears the origin rendezvous point (RP) address type of the SA entry

statistics

Syntax 
statistics [peer ip-address]
Context 
clear>router>msdp
Description 

This command clears IP address statistics of the peer to which Multicast Source Discovery Protocol (MSDP) source-active (SA) requests for groups matching this entry's group range were sent.

Parameters 
ip-address—
clears the statistics of the specified IP address

3.15.2.4. Debug Commands

3.15.2.4.1. Debug IGMP Commands

igmp

Syntax 
igmp
Context 
debug>router
Description 

This command enables access to the IGMP debug commands.

interface

Syntax 
[no] interface [ip-int-name | ip-address]
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP interfaces.

The no form of the command disables the IGMP interface debugging for the specified interface name or IP address.

Parameters 
ip-int-name—
displays the information associated with the specified IP interface name
ip-address—
displays the information associated with the specified IP address

misc

Syntax 
[no] misc
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP miscellaneous information.

The no form of the command disables the debugging.

packet

Syntax 
[no] packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address]
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP packets.

The no form of the command disables the debugging.

Parameters 
query—
specifies to log the IGMP group- and source-specific queries transmitted and received on this interface
v1-report —
specifies to log IGMPv1 reports transmitted and received on this interface
v2-report —
specifies to log IGMPv2 reports transmitted and received on this interface
v3-report —
specifies to log IGMPv3 reports transmitted and received on this interface
v2-leave—
specifies to log the IGMP Leaves transmitted and received on this interface
ip-int-name—
displays the information associated with the specified IP interface name
ip-address—
displays the information associated with the specified IP address

3.15.2.4.2. Debug MLD Commands

mld

Syntax 
mld
Context 
debug>router
Description 

This command enables access to the MLD debug commands.

interface

Syntax 
[no] interface [ip-int-name | ipv6-address]
Context 
debug>router>mld
Description 

This command enables debugging for MLD interfaces.

The no form of the command disables the MLD interface debugging for the specified interface name or IP address.

Parameters 
ip-int-name—
displays the information associated with the specified IP interface name
ipv6-address—
displays the information associated with the specified IP address

misc

Syntax 
[no] misc
Context 
debug>router>mld
Description 

This command enables debugging for MLD miscellaneous information.

The no form of the command disables the debugging.

packet

Syntax 
[no] packet [query | v1-report | v2-report | v1-done] [ip-int-name | ipv6-address]
Context 
debug>router>mld
Description 

This command enables debugging for MLD packets.

The no form of the command disables the debugging.

Parameters 
query—
specifies to log the MLD group- and source-specific queries transmitted and received on this interface
v1-report —
specifies to log MLDv1 reports transmitted and received on this interface
v2-report —
specifies to log MLDv2 reports transmitted and received on this interface
v1-done—
specifies to log the MLDv1 Done transmitted and received on this interface
ip-int-name—
displays the information associated with the specified IP interface name
ipv6-address—
displays the information associated with the specified IPv6 address
Values—
ipv6-address:      x:x:x:x:x:x:x:x (eight 16-bit pieces)
                           x:x:x:x:x:x:d.d.d.d
                            x: [0..FFFF]H
                            d: [0..255]D

 

3.15.2.4.3. Debug PIM Commands

pim

Syntax 
pim
Context 
debug>router
Description 

This command enables access to the PIM debug commands.

adjacency

Syntax 
[no] adjacency
Context 
debug>router>pim
Description 

This command enables debugging for PIM adjacencies.

The no form of the command disables debugging.

all

Syntax 
all [group grp-ip-address] [source ip-address] [detail]
no all
Context 
debug>router>pim
Description 

This command enables debugging for all the PIM groups.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with all PIM groups for the specified multicast group address
Values—
IPv4 or IPv6 address

 

ip-address—
debugs information associated with all PIM groups for the specified source address
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on all PIM groups

assert

Syntax 
assert [group grp-ip-address] [source ip-address] [detail]
no assert
Context 
debug>router>pim
Description 

This command enables debugging for the PIM assert mechanism.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with the PIM assert mechanism for the specified multicast group address
Values—
IPv4 or IPv6 address

 

ip-address—
debugs information associated with the PIM assert mechanism for the specified source address
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on the PIM assert mechanism

auto-rp

Syntax 
auto-rp [detail]
no auto-rp
Context 
debug>router>pim
Description 

This command enables debugging for PIM auto-RP.

The no form of the command disables debugging.

Parameters 
detail—
debugs detailed information on the PIM auto-RP mechanism

bgp

Syntax 
bgp [source src-ip-address] [group grp-ip-address] [peer peer-ip-address]
no bgp
Context 
debug>router>pim
Description 

This command enables debugging for the PIM BGP mechanism.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs PIM BGP information associated with the specified group IP address
Values—
IPv4 or IPv6 address

 

peer-ip-address—
debugs PIM BGP information associated with the specified peer IP address
Values—
IPv4 or IPv6 address

 

src-ip-address—
debugs PIM BGP information associated with the specified source IP address
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed PIM BGP information

bsr

Syntax 
bsr [detail]
no bsr
Context 
debug>router>pim
Description 

This command enables debugging for the PIM Bootstrap mechanism.

The no form of the command disables debugging.

Parameters 
detail—
debugs detailed information on the PIM Bootstrap mechanism

data

Syntax 
data [group grp-ip-address] [source ip-address] [detail]
no data
Context 
debug>router>pim
Description 

This command enables debugging for the PIM data exception.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with the PIM data exception for the specified multicast group address
Values—
IPv4 or IPv6 address

 

ip-address—
debugs information associated with the PIM data exception for the specified source address
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on the PIM data exception

db

Syntax 
db [group grp-ip-address] [source ip-address] [detail]
no db
Context 
debug>router>pim
Description 

This command enables debugging for the PIM database.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with the PIM database for the specified multicast group address
Values—
IPv4 or IPv6 address or zero address

 

ip-address—
debugs information associated with the PIM database for the specified source address
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on the PIM database

interface

Syntax 
interface [ip-int-name | int-ip-address] [detail]
no interface
Context 
debug>router>pim
Description 

This command enables debugging for the PIM interface.

The no form of the command disables debugging.

Parameters 
ip-int-name—
debugs information associated with the specified IP interface name
Values—
IPv4 or IPv6 address

 

int-ip-address—
debugs information associated with the specified IP address
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on the IP interface

jp

Syntax 
jp [group grp-ip-address] [source ip-address] [detail]
no jp
Context 
debug>router>pim
Description 

This command enables debugging for the PIM Join-Prune mechanism.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with the specified PIM Join-Prune mechanism
Values—
IPv4 or IPv6 address or zero address

 

ip-address—
debugs information associated with the specified PIM Join-Prune mechanism
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on the PIM Join-Prune mechanism

mrib

Syntax 
mrib [group grp-ip-address] [source ip-address] [detail]
no mrib
Context 
debug>router>pim
Description 

This command enables debugging for the PIM MRIB.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with the specified PIM MRIB
Values—
IPv4 or IPv6 address

 

ip-address—
debugs information associated with the specified PIM MRIB
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on PIM MRIBs

msg

Syntax 
msg [detail]
no msg
Context 
debug>router>pim
Description 

This command enables debugging for PIM messaging.

The no form of the command disables debugging.

Parameters 
detail—
debugs detailed information on PIM messaging

packet

Syntax 
packet [hello | register | register-stop | jp | bsr | assert | crp] [ip-int-name | int-ip-address]
no packet
Context 
debug>router>pim
Description 

This command enables debugging for PIM packets.

The no form of the command disables debugging.

Parameters 
ip-int-name—
debugs information associated with the specified IP interface name
Values—
IPv4 or IPv6 interface name

 

int-ip-address—
debugs information associated with the specified IP address of a particular packet type

red

Syntax 
[no] red [detail]
Context 
debug>router>pim
Description 

This command enables debugging for the PIM redundancy mechanism.

The no form of the command disables debugging.

Parameters 
detail—
debugs detailed information on the PIM redundancy mechanism

register

Syntax 
register [group grp-ip-address] [source ip-address] [detail]
no register
Context 
debug>router>pim
Description 

This command enables debugging for the PIM register mechanism.

The no form of the command disables debugging.

Parameters 
grp-ip-address—
debugs information associated with the specified PIM register
Values—
IPv4 or IPv6 address

 

ip-address—
debugs information associated with the specified PIM register
Values—
IPv4 or IPv6 address

 

detail—
debugs detailed information on the PIM register mechanism

rtm

Syntax 
rtm [detail]
no rtm
Context 
debug>router>pim
Description 

This command enables debugging for the PIM RTM.

The no form of the command disables debugging.

Parameters 
detail—
debugs detailed information on the PIM RTM

3.15.2.4.4. Debug Mtrace Commands

mtrace

Syntax 
[no] mtrace
Context 
debug>router
Description 

This command enables access to the mtrace debug commands.

The no form of the command disables the debugging.

misc

Syntax 
[no] misc
Context 
debug>router>mtrace
Description 

This command enables debugging for mtrace miscellaneous events.

The no form of the command disables the debugging.

packet

Syntax 
[no] packet [query | request | response]
Context 
debug>router>mtrace
Description 

This command enables debugging for mtrace packets.

The no form of the command disables the debugging.

Parameters 
query—
specifies to log the mtrace queries transmitted and received
request—
specifies to log the mtrace requests transmitted and received
response—
specifies to log the mtrace responses transmitted and received

3.15.2.5. Monitor Commands

group

Syntax 
group grp-ip-address [source ip-address] [interval interval] [repeat repeat] [absolute | rate]
Context 
monitor>router>pim
Description 

This command monitors statistics for a PIM source group.

Parameters 
grp-ip-address—
specifies the IP address of a multicast group that identifies a set of recipients that are interested in a particular data stream
Values—
IPv4 or IPv6 address

 

ip-address—
specifies the source IP address to use in the ping requests
Values—
IPv4 or IPv6 address

 

Default—
0.0.0.0 to 255.255.255.255
interval—
specifies the interval for each display, in seconds
Values—
10 | 20 | 30 | 40 | 50 | 60

 

Default—
10
repeat—
specifies the number of times the command is repeated
Values—
1 to 999

 

Default—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate—
displays the rate per second for each statistic, instead of the delta