Cisco Nexus 7000 Series NX-OS Multicast Routing Command Reference, Release 4.0
I Commands

Table Of Contents

I Commands

ip igmp access-group

ip igmp flush-routes

ip igmp group-timeout

ip igmp join-group

ip igmp last-member-query-count

ip igmp last-member-query-response-time

ip igmp querier-timeout

ip igmp query-interval

ip igmp query-max-response-time

ip igmp query-timeout

ip igmp report-link-local-groups

ip igmp report-policy

ip igmp robustness-variable

ip igmp snooping (Global)

ip igmp snooping (VLAN)

ip igmp snooping explicit-tracking

ip igmp snooping fast-leave

ip igmp snooping last-member-query-interval

ip igmp snooping mrouter interface

ip igmp snooping querier

ip igmp snooping report-suppression

ip igmp snooping static-group

ip igmp snooping v3-report-suppression

ip igmp ssm-translate

ip igmp startup-query-count

ip igmp startup-query-interval

ip igmp state-limit

ip igmp static-oif

ip igmp version

ip mroute

ip msdp description

ip msdp flush-routes

ip msdp group-limit

ip msdp keepalive

ip msdp mesh-group

ip msdp originator-id

ip msdp password

ip msdp peer

ip msdp reconnect-interval

ip msdp sa-interval

ip msdp sa-limit

ip msdp sa-policy in

ip msdp sa-policy out

ip msdp shutdown

ip pim anycast-rp

ip pim auto-rp listen

ip pim auto-rp mapping-agent

ip pim auto-rp mapping-agent-policy

ip pim auto-rp rp-candidate

ip pim auto-rp rp-candidate-policy

ip pim bidir-rp-limit

ip pim border

ip pim bsr bsr-policy

ip pim bsr forward

ip pim bsr listen

ip pim bsr rp-candidate-policy

ip pim bsr-candidate

ip pim dr-priority

ip pim flush-routes

ip pim hello-authentication ah-md5

ip pim hello-interval

ip pim jp-policy

ip pim log-neighbor-changes

ip pim neighbor-policy

ip pim register-policy

ip pim register-rate-limit

ip pim rp-address

ip pim rp-candidate

ip pim send-rp-announce

ip pim send-rp-discovery

ip pim sparse-mode

ip pim ssm range

ip pim state-limit

ip pim use-shared-tree-only

ipv6 mld access-group

ipv6 mld group-timeout

ipv6 mld join-group

ipv6 mld last-member-query-count

ipv6 mld last-member-query-response-time

ipv6 mld querier-timeout

ipv6 mld query-interval

ipv6 mld query-max-response-time

ipv6 mld query-timeout

ipv6 mld report-link-local-groups

ipv6 mld report-policy

ipv6 mld robustness-variable

ipv6 mld ssm-translate

ipv6 mld startup-query-count

ipv6 mld startup-query-interval

ipv6 mld state-limit

ipv6 mld static-oif

ipv6 mld version

ipv6 mroute

ipv6 pim anycast-rp

ipv6 pim bidir-rp-limit

ipv6 pim border

ipv6 pim bsr bsr-policy

ipv6 pim bsr forward

ipv6 pim bsr listen

ipv6 pim bsr rp-candidate-policy

ipv6 pim bsr-candidate

ipv6 pim dr-priority

ipv6 pim flush-routes

ipv6 pim hello-interval

ipv6 pim jp-policy

ipv6 pim log-neighbor-changes

ipv6 pim neighbor-policy

ipv6 pim register-policy

ipv6 pim register-rate-limit

ipv6 pim rp-address

ipv6 pim rp-candidate

ipv6 pim sparse-mode

ipv6 pim ssm range

ipv6 pim state-limit

ipv6 pim use-shared-tree-only


I Commands


This chapter describes the Cisco NX-OS multicast routing commands that begin with I.

ip igmp access-group

To enable a routing-rules policy to control the multicast groups that hosts on the subnet serviced by an interface can join, use the ip igmp access-group command. To disable the routing-rules policy, use the no form of this command.

ip igmp access-group policy-name

no ip igmp access-group [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable a routing-rules policy:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp access-group my_access_group_policy
switch(config-if)# 

This example shows how to disable a routing-rules policy:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp access-group
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp flush-routes

To remove routes when the IGMP process is restarted, use the ip igmp flush-routes command. To leave routes in place, use the no form of this command.

ip igmp flush-routes

no ip igmp flush-routes

Syntax Description

This command has no arguments or keywords.

Defaults

The routes are not flushed.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display whether flush routes are configured, use this command line:

switch(config)# show running-config | include flush-routes

This command does not require a license.

Examples

This example shows how to remove routes when the IGMP process is restarted:

switch(config)# ip igmp flush-routes

This example shows how to leave routes in place when the IGMP process is restarted:

switch(config)# no ip igmp flush-routes

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ip igmp group-timeout

To configure a group membership timeout for IGMPv2, use the ip igmp group-timeout command. To return to the default timeout, use the no form of this command.

ip igmp group-timeout timeout

no ip igmp group-timeout [timeout]

Syntax Description

timeout

Timeout in seconds. The range is from 3 to 65,535. The default is 260.


Defaults

The group membership timeout is 260 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a group membership timeout:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp group-timeout 200
switch(config-if)# 

This example shows how to reset a group membership timeout to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp group-timeout
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp join-group

To statically bind a multicast group to an interface, use the ip igmp join-group command. To remove a group binding, use the no form of this command.

ip igmp join-group group [source source]

no ip igmp join-group group [source source]

Syntax Description

group

Multicast group IP address.

source source

(Optional) Configures a source IP address for the IGMPv3 (S,G) channel.


Defaults

None

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

If you specify only the group address, the (*, G) state is created. If you specify the source address, the (S, G) state is created.


Note A source tree is built for the (S, G) state only if you enable IGMPv3.



Caution When you enter this command, the traffic generated is handled by the device CPU, not the hardware.

This command does not require a license.

Examples

This example shows how to statically bind a group to an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp join-group 230.0.0.0
switch(config-if)# 

This example shows how to remove a group binding from an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp join-group 230.0.0.0
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp last-member-query-count

To configure the number of times that the software sends an IGMP query in response to a host leave message, use the ip igmp last-member-query-count command. To reset the query interval to the default, use the no form of this command.

ip igmp last-member-query-count count

no ip igmp last-member-query-count [count]

Syntax Description

count

Query count. The range is from 1 to 5. The default is 2.


Defaults

The query count is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query count:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp last-member-query-count 3
switch(config-if)# 

This example shows how to reset a query count to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp last-member-query-count
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp last-member-query-response-time

To configure a query interval in which the software sends membership reports and then deletes the group state, use the ip igmp last-member-query-response-time command. To reset the query interval to the default, use the no form of this command.

ip igmp last-member-query-response-time interval

no ip igmp last-member-query-response-time [interval]

Syntax Description

interval

Query interval in seconds. The range is from 1 to 25. The default is 1.


Defaults

The query interval is 1 second.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query interval:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp last-member-query-response-time 3
switch(config-if)# 

This example shows how to reset a query interval to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp last-member-query-response-time
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp querier-timeout

To configure a querier timeout that the software uses when deciding to take over as the querier, use the ip igmp querier-timeout command. To reset to the querier timeout to the default, use the no form of this command.

ip igmp querier-timeout timeout

no ip igmp querier-timeout [timeout]

Syntax Description

timeout

Timeout in seconds. The range is from 1 to 65,535. The default is 255.


Defaults

The querier timeout is 255 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The ip igmp query-timeout command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to configure a querier timeout:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp querier-timeout 200
switch(config-if)# 

This example shows how to reset a querier timeout to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp querier-timeout
switch(config-if)# 

Related Commands

Command
Description

ip igmp query-timeout

Configures a querier timeout.

show ip igmp interface

Displays IGMP information about the interface.


ip igmp query-interval

To configure a query interval used when the IGMP process starts up, use the ip igmp query-interval command. To reset the query interval to the default, use the no form of this command.

ip igmp query-interval interval

no ip igmp query-interval [interval]

Syntax Description

interval

Interval in seconds. The range is from 1 to 18,000. The default is 125.


Defaults

The query interval is 125 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query interval:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp query-interval 100
switch(config-if)# 

This example shows how to reset a query interval to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp query-interval
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp query-max-response-time

To configure a query maximum response time that is advertised in IGMP queries, use the ip igmp query-max-response-time command. To reset the response time to the default, use the no form of this command.

ip igmp query-max-response-time time

no ip igmp query-max-response-time [time]

Syntax Description

time

Query maximum response time in seconds. The range is from 1 to 25. The default is 10.


Defaults

The query maximum response time is 10 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query maximum response time:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp query-max-response-time 15
switch(config-if)# 

This example shows how to reset a query maximum response time to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp query-max-response-time
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp query-timeout

To configure a query timeout that the software uses when deciding to take over as the querier, use the ip igmp query-timeout command. To reset to the querier timeout to the default, use the no form of this command.

ip igmp query-timeout timeout

no ip igmp query-timeout [timeout]

Syntax Description

timeout

Timeout in seconds. The range is from 1 to 65,535. The default is 255.


Defaults

The query timeout is 255 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The ip igmp querier-timeout command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to configure a querier timeout:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp query-timeout 200
switch(config-if)# 

This example shows how to reset a querier timeout to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp query-timeout
switch(config-if)# 

Related Commands

Command
Description

ip igmp querier-timeout

Configures a querier timeout.

show ip igmp interface

Displays IGMP information about the interface.


ip igmp report-link-local-groups

To enable IGMP to send reports for link-local groups, use the ip igmp report-link-local-groups command. To disable sending reports to link-local groups, use the no form of this command.

ip igmp report-link-local-groups

no ip igmp report-link-local-groups

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable sending reports to link-local groups:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp report-link-local-groups
switch(config-if)# 

This example shows how to disable sending reports to link-local groups:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp report-link-local-groups
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp report-policy

To enable an access policy that is based on a routing-rules policy for IGMP reports, use the ip igmp report-policy command. To disable the routing-rules policy, use the no form of this command.

ip igmp report-policy policy-name

no ip igmp report-policy [policy-name]

Syntax Description

report-policy

IGMP Report Policy.

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable an access policy for IGMP reports:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp report-policy my_report_policy
switch(config-if)# 

This example shows how to disable an access policy for IGMP reports:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp report-policy
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp robustness-variable

To configure a robustness count that you can tune to reflect expected packet loss on a congested network, use the ip igmp robustness-variable command. To reset the count to the default, use the no form of this command.

ip igmp robustness-variable count

no ip igmp robustness-variable [count]

Syntax Description

count

Robustness count. The range is from 1 to 7. The default is 2.


Defaults

The robustness count is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a robustness count:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp robustness-variable 3
switch(config-if)# 

This example shows how to reset a robustness count to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp robustness-variable
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp snooping (Global)

To enable IGMP snooping for the current virtual device configuration (VDC), use the ip igmp snooping command. To disable IGMP snooping for the current VDC, use the no form of this command.

ip igmp snooping

no ip igmp snooping

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

If the global configuration of IGMP snooping is disabled, then all VLANs are treated as disabled, whether they are enabled or not.

This command does not require a license.

Examples

This example shows how to enable IGMP snooping for the current VDC:

switch(config)# ip igmp snooping
switch(config)# 

This example shows how to disable IGMP snooping for the current VDC:

switch(config)# no ip igmp snooping
switch(config)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping (VLAN)

To enable IGMP snooping on a VLAN interface, use the ip igmp snooping command. To disable IGMP snooping on the interface, use the no form of this command.

ip igmp snooping

no ip igmp snooping

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

If the global configuration of IGMP snooping is disabled, then all VLANs are treated as disabled, whether they are enabled or not.

This command does not require a license.

Examples

This example shows how to enable IGMP snooping on a VLAN interface:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping
switch(config-vlan)# 

This example shows how to disable IGMP snooping on a VLAN interface:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping explicit-tracking

To enable tracking of IGMPv3 membership reports from individual hosts for each port on a per-VLAN basis, use the ip igmp snooping explicit-tracking command. To disable tracking, use the no form of this command.

ip igmp snooping explicit-tracking

no ip igmp snooping explicit-tracking

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable tracking of IGMPv3 membership reports on a VLAN interface:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping explicit-tracking
switch(config-vlan)# 

This example shows how to disable IGMP snooping on a VLAN interface:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping explicit-tracking
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping fast-leave

To enable support of IGMPv2 hosts that cannot be explicitly tracked because of the host report suppression mechanism of the IGMPv2 protocol, use the ip igmp snooping fast-leave command. To disable support of IGMPv2 hosts, use the no form of this command.

ip igmp snooping fast-leave

no ip igmp snooping fast-leave

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

When you enable fast leave, the IGMP software assumes that no more than one host is present on each VLAN port.

This command does not require a license.

Examples

This example shows how to enable support of IGMPv2 hosts:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping fast-leave
switch(config-vlan)# 

This example shows how to disable support of IGMPv2 hosts:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping fast-leave
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping last-member-query-interval

To configure a query interval in which the software removes a group, use the ip igmp snooping last-member-query-interval command. To reset the query interval to the default, use the no form of this command.

ip igmp snooping last-member-query-interval interval

no ip igmp snooping last-member-query-interval [interval]

Syntax Description

interval

Query interval in seconds. The range is from 1 to 25. The default is 1.


Defaults

The query interval is 1.

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query interval in which the software removes a group:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping last-member-query-interval 3
switch(config-vlan)# 

This example shows how to reset a query interval to the default:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping last-member-query-interval
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping mrouter interface

To configure a static connection to a multicast router, use the ip igmp snooping mrouter interface command. To remove the static connection, use the no form of this command.

ip igmp snooping mrouter interface if-type if-number

no ip igmp snooping mrouter interface if-type if-number

Syntax Description

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

None

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The interface to the router must be in the selected VLAN.

This command does not require a license.

Examples

This example shows how to configure a static connection to a multicast router:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping mrouter interface ethernet 2/1
switch(config-vlan)# 

This example shows how to remove a static connection to a multicast router:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping mrouter interface ethernet 2/1
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping querier

To configure a snooping querier on an interface when you do not enable Protocol Independent Multicast (PIM) because multicast traffic does not need to be routed, use the ip igmp snooping querier command. To remove the snooping querier, use the no form of this command.

ip igmp snooping querier querier

no ip igmp snooping querier [querier]

Syntax Description

querier

Querier IP address.


Defaults

None

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a snooping querier:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping querier 172.20.52.106
switch(config-vlan)# 

This example shows how to disable IGMP snooping on a VLAN interface:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping querier
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping report-suppression

To enable limiting the membership report traffic sent to multicast-capable routers, use the ip igmp snooping report-suppression command. To disable the limitation, use the no form of this command.

ip igmp snooping report-suppression

no ip igmp snooping report-suppression

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration (config)
VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

Global configuration mode was added.


Usage Guidelines

When you disable report suppression, all IGMP reports are sent as is to multicast-capable routers.

This command does not require a license.

Examples

This example shows how to enable limiting the membership report traffic:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping report-suppression
switch(config-vlan)# 

This example shows how to disable limiting the membership report traffic:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping report-suppression
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping static-group

To configure a Layer 2 port of a VLAN as a static member of a multicast group, use the ip igmp snooping static-group command. To remove the static member, use the no form of this command.

ip igmp snooping static-group group [source source] interface if-type if-number

no ip igmp snooping static-group group [source source] interface if-type if-number

Syntax Description

group

Group IP address.

source source

(Optional) Configures a static (S, G) channel for the source IP address.

interface

Specifies interface for static group.

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

None

Command Modes

VLAN configuration (config-vlan)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a static member of a multicast group:

switch(config)# vlan 1
switch(config-vlan)# ip igmp snooping static-group 230.0.0.1 interface ethernet 2/1
switch(config-vlan)# 

This example shows how to remove a static member of a multicast group:

switch(config)# vlan 1
switch(config-vlan)# no ip igmp snooping static-group 230.0.0.1 interface ethernet 2/1
switch(config-vlan)# 

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp snooping v3-report-suppression

To configure IGMPv3 report suppression and proxy reporting for VLANs, use the ip igmp snooping v3-report-suppression command. To remove IGMPv3 report supression, use the no form of this command.

ip igmp snooping v3-report-suppression

no ip igmp snooping v3-report-suppression

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure IGMPv3 report suppression and proxy reporting for VLANs:

switch(config)# ip igmp snooping v3-report-suppression

This example shows how to remove IGMPv3 report suppression:

switch(config)# no ip igmp snooping v3-report-suppression

Related Commands

Command
Description

show ip igmp snooping

Displays IGMP snooping information.


ip igmp ssm-translate

To translate IGMPv1 or IGMPv2 membership reports to create the (S, G) state so that the router treats them as IGMPv3 membership reports, use the ip igmp ssm-translate command. To remove the translation, use the no form of this command.

ip igmp ssm-translate group source

no ip igmp ssm-translate group source

Syntax Description

group

IPv4 multicast group range. By default, the group prefix range is 232.0.0.0/8. To modify the IPv4 Protocol Independent Multicast (PIM) SSM range, see the ip pim ssm range command.

source

IP multicast address source.


Defaults

None

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display SSM translation commands, use this command line:

switch(config)# show running-config | include ssm-translation

This command does not require a license.

Examples

This example shows how to configure a translation:

switch(config)# ip igmp ssm-translate 232.0.0.0/8 10.1.1.1

This example shows how to remove a translation:

switch(config)# no ip igmp ssm-translate 232.0.0.0/8 10.1.1.1

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ip igmp startup-query-count

To configure the query count used when the IGMP process starts up, use the ip igmp startup-query-count command. To reset the query count to the default, use the no form of this command.

ip igmp startup-query-count count

no ip igmp startup-query-count [count]

Syntax Description

count

Query count. The range is from 1 to 10. The default is 2.


Defaults

The query count is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a query count:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp startup-query-count 3
switch(config-if)# 

This example shows how to reset a query count to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp startup-query-count
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp startup-query-interval

To configure the query interval used when the IGMP process starts up, use the ip igmp startup-query-interval command. To reset the query interval to the default, use the no form of this command.

ip igmp startup-query-interval interval

no ip igmp startup-query-interval [interval]

Syntax Description

interval

Query interval in seconds. The range is from 1 to 18,000. The default is 31.


Defaults

The query interval is 31 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a startup query interval:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp startup-query-interval 25
switch(config-if)# 

This example shows how to reset a startup query interval to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp startup-query-interval
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp state-limit

To configure the maximum states allowed, use the ip igmp state-limit command. To remove the state limit, use the no form of this command.

ip igmp state-limit max-states [reserved reserve-policy max-reserved]

no ip igmp state-limit [max-states [reserved reserve-policy max-reserved]]

Syntax Description

max-states

Maximum states allowed. The range is from 1 to 4,294,967,295.

reserved reserve-policy max-reserved

(Optional) Specifies to use the routing-rules policy name for the reserve policy and set the maximum number of (*, G) and (S, G) entries allowed on the interface.


Defaults

None

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a state limit:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp state-limit 5000
switch(config-if)# 

This example shows how to remove a state limit:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp state-limit
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip igmp static-oif

To statically bind a multicast group to the outgoing interface (OIF), which is handled by the device hardware, use the ip igmp static-oif command. To remove a static group, use the no form of this command.

ip igmp static-oif group [source source]

no ip igmp static-oif group [source source]

Syntax Description

group

Multicast group IPv4 address. If you specify only the group address, the (*, G) state is created.

source source

(Optional) Configures the source IP address for IGMPv3 and creates the (S, G) state.

Note A source tree is built for the (S, G) state only if you enable IGMPv3.


Defaults

None

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to statically bind a group to the OIF:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp static-oif 230.0.0.0
switch(config-if)# 

This example shows how to remove a static binding from the OIF:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp static oif 230.0.0.0
switch(config-if)# 

Related Commands

Command
Description

show ip igmp local-groups

Displays information about IGMP local group membership.


ip igmp version

To configure the IGMP version to use on an interface, use the ip igmp version command. To reset the IGMP version to the default, use the no form of this command.

ip igmp version version

no ip igmp version [version]

Syntax Description

version

Version number. The number is 2 or 3. The default is 2.


Defaults

The version number is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IGMP version to use on an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp version 3
switch(config-if)# 

This example shows how to reset the IGMP version to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip igmp version
switch(config-if)# 

Related Commands

Command
Description

show ip igmp interface

Displays IGMP information about the interface.


ip mroute

To configure multicast RPF static routes, use the ip mroute command. To remove RPF static routes, use the no form of this command.

ip mroute {ip-addr ip-mask | ip-prefix} {{next-hop | nh-prefix} | if-type if-number} [pref] [vrf vrf-name]

no ip mroute {ip-addr ip-mask | ip-prefix} {{next-hop | nh-prefix} | if-type if-number} [pref] [vrf vrf-name]

Syntax Description

ip-addr

IP prefix in the format i.i.i.i.

ip-mask

IP network mask in the format m.m.m.m.

ip-prefix

IP prefix and network mask length in the format x.x.x.x/m.

next-hop

IP next-hop address in the format i.i.i.i.

nh-prefix

IP next-hop prefix in the format i.i.i.i/m.

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

pref

(Optional) Route preference. The range is from 1 to 255. The default is 1.

vrf vrf-name

(Optional) Applies to the specified virtual routing and forwarding (VRF) instance.


Defaults

The route preference is 1.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure an RPF static route:

switch(config)# ip mroute 192.168.1.0/24 192.168.2.0/24
switch(config)#

This example shows how to remove an RPF static route:

switch(config)# no ip mroute 192.168.1.0/24 192.168.2.0/24
switch(config)#

Related Commands

Command
Description

show ip mroute

Displays information about multicast routes.


ip msdp description

To configure a description for the Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp description command. To remove the description for the peer, use the no form of this command.

ip msdp description peer-address text

no ip msdp description peer-address [text]

Syntax Description

peer-address

IP address of MSDP peer.

text

Text description.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure an MSDP peer description:

switch(config)# ip msdp description 192.168.1.10 engineering peer

This example shows how to remove an MSDP peer description:

switch(config)# no ip msdp description 192.168.1.10

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip msdp flush-routes

To flush routes when the Multicast Source Discovery Protocol (MSDP) process is restarted, use the ip msdp flush-routes command. To leave routes in place, use the no form of this command.

ip msdp flush-routes

no ip msdp flush-routes

Syntax Description

This command has no arguments or keywords.

Defaults

The routes are not flushed.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display whether flush routes is configured, use this command line:

switch(config)# show running-config | include flush-routes

This command requires the Enterprise Services license.

Examples

This example shows how to configure flushing routes when the MSDP process is restarted:

switch(config)# ip msdp flush-routes

This example shows how to configure leaving routes when the MSDP process is restarted:

switch(config)# no ip msdp flush-routes

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ip msdp group-limit

To configure the Multicast Source Discovery Protocol (MSDP) maximum number of (S, G) entries that the software creates for the specified prefix, use the ip msdp group-limit command. To remove the group limit, use the no form of this command.

ip msdp group-limit limit source prefix

no ip msdp group-limit limit source prefix

Syntax Description

limit

Limit on number of groups. The range is from 0 to 4294967295. The default is no limit.

source prefix

Specifies the prefix to match sources against.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure the maximum number of (S, G) entries to create for a source:

switch(config)# ip msdp group-limit 4000 source 192.168.1.0/24

This example shows how to remove the limit entries to create:

switch(config)# no ip msdp group-limit 4000 source 192.168.1.0/24

Related Commands

Command
Description

show ip msdp sources

Displays information about the MSDP learned sources and group limit.


ip msdp keepalive

To configure a Multicast Source Discovery Protocol (MSDP) peer keepalive interval and timeout, use the ip msdp keepalive command. To reset the timeout and interval to the default, use the no form of this command.

ip msdp keepalive peer-address interval timeout

no ip msdp keepalive peer-address [interval timeout]

Syntax Description

peer-address

IP address of an MSDP peer.

interval

Keepalive interval in seconds. The range is from 1 to 60. The default is 60.

timeout

Keepalive timeout in seconds. The range is from 1 to 90. The default is 90.


Defaults

The keepalive interval is 60 seconds.

The keepalive timeout is 90 seconds.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure an MSDP peer keepalive interval and timeout:

switch(config)# ip msdp keepalive 192.168.1.10 60 80

This example shows how to reset a keepalive interval and timeout to the default:

switch(config)# no ip msdp keepalive 192.168.1.10

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip msdp mesh-group

To configure a Multicast Source Discovery Protocol (MSDP) mesh group with a peer, use the ip msdp mesh-group command. To remove the peer from one or all mesh groups, use the no form of this command.

ip msdp mesh-group peer-address name

no ip msdp mesh-group peer-address [name]

Syntax Description

peer-address

IP address of an MSDP peer in a mesh group.

name

Name of mesh-group.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a mesh group with a peer:

switch(config)# ip msdp mesh-group 192.168.1.10 my_admin_mesh

This example shows how to remove a peer from a mesh group:

switch(config)# no ip msdp mesh-group 192.168.1.10 my_admin_mesh

Related Commands

Command
Description

show ip msdp mesh-group

Displays information about MSDP mesh groups.


ip msdp originator-id

To configure the IP address used in the RP field of a Source-Active message entry, use the ip msdp originator-id command. To reset the value to the default, use the no form of this command.

ip msdp originator-id if-type if-number

no ip msdp originator-id [if-type if-number]

Syntax Description

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

The MSDP process uses the RP address of the local system.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

We recommend that you use a loopback interface for the RP address.

This command requires the Enterprise Services license.

Examples

This example shows how to configure the IP address used in the RP field of SA messages:

switch(config)# ip msdp originator-id loopback0

This example shows how to reset the RP address to the default:

switch(config)# no ip msdp originator-id loopback0

Related Commands

Command
Description

show ip msdp summary

Displays a summary of MDSP information.


ip msdp password

To enable a Multicast Source Discovery Protocol (MSDP) MD5 password for the peer, use the ip msdp password command. To disable an MD5 password for a peer, use the no form of this command.

ip msdp password peer-address password

no ip msdp password peer-address [password]

Syntax Description

peer-address

IP address of an MSDP peer.

password

MD5 password.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable an MD5 password for a peer:

switch(config)# ip msdp password 192.168.1.10 my_password

This example shows how to disable an MD5 password for a peer:

switch(config)# no ip msdp password 192.168.1.10

Related Commands

Command
Description

show ip msdp peer

Displays MDSP peer information.


ip msdp peer

To configure a Multicast Source Discovery Protocol (MSDP) peer with the specified peer IP address., use the ip msdp peer command. To remove an MDSP peer, use the no form of this command.

ip msdp peer peer-address connect-source if-type if-number [remote-as asn]

no ip msdp peer peer-address [connect-source if-type if-number] [remote-as asn]

Syntax Description

peer-address

IP address of the MSDP peer.

connect-source

Configure a local IP address for a TCP connection.

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

remote-as asn

(Optional) Configures a remote autonomous system (AS) number.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

Remote AS number was made an optional argument.


Usage Guidelines

The software uses the source IP address of the interface for the TCP connection with the peer. If the AS number is the same as the local AS, then the peer is within the Protocol Independent Multicast (PIM) domain; otherwise, this peer is external to the PIM domain.

This command requires the Enterprise Services license.

Examples

This example shows how to configure an MSDP peer:

switch(config)# ip msdp peer 192.168.1.10 connect-source ethernet 1/0 remote-as 8

This example shows how to remove an MSDP peer:

switch(config)# no ip msdp peer 192.168.1.10

Related Commands

Command
Description

show ip msdp summary

Displays a summary of MSDP information.


ip msdp reconnect-interval

To configure a reconnect interval for the TCP connection, use the ip msdp reconnect-interval command. To reset a reconnect interval to the default, use the no form of this command.

ip msdp reconnect-interval interval

no ip msdp reconnect-interval [interval]

Syntax Description

interval

Reconnect interval in seconds. The range is from 1 to 60. The default is 10.


Defaults

The reconnect interval is 10 seconds.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a reconnect interval for the TCP connection:

switch(config)# ip msdp reconnect-interval 20

This example shows how to reset a reconnect interval to the default:

switch(config)# no ip msdp reconnect-interval

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip msdp sa-interval

To configure the interval at which the software transmits Source-Active (SA) messages, use the ip msdp sa-interval command. To reset the interval to the default, use the no form of this command.

ip msdp sa-interval interval

no ip msdp sa-interval [interval]

Syntax Description

interval

SA transmission interval in seconds. The range is from from 60 to 65,535. The default is 60.


Defaults

The SA message interval is 60 seconds.

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display the SA interval configuration command, use this command line:

switch(config)# show running-config | include sa-interval

This command requires the Enterprise Services license.

Examples

This example shows how to configure an SA transmission interval:

switch(config)# ip msdp sa-interval 100

This example shows how to reset the interval to the default:

switch(config)# no ip msdp sa-interval

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ip msdp sa-limit

To configure a limit on the number of (S, G) entries accepted from the peer, use the ip msdp sa-limit command. To remove the limit, use the no form of this command.

ip msdp sa-limit peer-address limit

no ip msdp sa-limit peer-address [limit]

Syntax Description

peer-address

IP address of an MSDP peer.

limit

Number of (S, G) entries. The range is from 0 to 4294967295. The default is none.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a Source-Active (SA) limit for a peer:

switch(config)# ip msdp sa-limit 192.168.1.10 5000

This example shows how to reset the limit to the default:

switch(config)# no ip msdp sa-limit 192.168.1.10

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip msdp sa-policy in

To enable filtering of incoming Multicast Source Discovery Protocol (MSDP) Source-Active (SA) messages, use the ip msdp sa-policy in command. To disable filtering, use the no form of this command.

ip msdp sa-policy peer-address policy-name in

no ip msdp sa-policy peer-address policy-name in

Syntax Description

peer-address

IP address of an MSDP peer.

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable filtering of incoming SA messages:

switch(config)# ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy in

This example shows how to disable filtering:

switch(config)# no ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy in

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip msdp sa-policy out

To enable filtering of outgoing Source-Active (SA) messages, use the ip msdp sa-policy out command. To disable filtering, use the no form of this command.

ip msdp sa-policy peer-address policy-name out

no ip msdp sa-policy peer-address policy-name out

Syntax Description

peer-address

IP address of an MSDP peer.

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable filtering of SA messages:

switch(config)# ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy out

This example shows how to disable filtering:

switch(config)# no ip msdp sa-policy 192.168.1.10 my_incoming_sa_policy out

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip msdp shutdown

To shut down a Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp shutdown command. To enable the peer, use the no form of this command.

ip msdp shutdown peer-address

no ip msdp shutdown peer-address

Syntax Description

peer-address

IP address of an MSDP peer.


Defaults

Enabled

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to disable an MSDP peer:

switch(config)# ip msdp shutdown 192.168.1.10

This example shows how to enable an MSDP peer:

switch(config)# no ip msdp shutdown 192.168.1.10

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


ip pim anycast-rp

To configure an IPv4 Protocol Independent Multicast (PIM) Anycast-RP peer for the specified Anycast-RP address, use the ip pim anycast-rp command. To remove the peer, use the no form of this command.

ip pim anycast-rp anycast-rp rp-addr

no ip pim anycast-rp anycast-rp rp-addr

Syntax Description

anycast-rp

Anycast-RP address of the peer.

rp-addr

Address of RP in the Anycast-RP set.


Defaults

None

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Each command with the same Anycast-RP address forms an Anycast-RP set. The IP addresses of RPs are used for communication with RPs in the set.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a PIM Anycast-RP peer:

switch(config)# ip pim anycast-rp 192.0.2.3 192.0.2.31

This example shows how to remove a peer:

switch(config)# no ip pim anycast-rp 192.0.2.3 192.0.2.31

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim auto-rp listen

To enable Protocol Independent Multicast (PIM) listening and forwarding of Auto-RP messages, use the ip pim auto-rp listen and ip pim auto-rp forward commands. To disable the listening and forwarding of Auto-RP messages, use the no form of this command.

ip pim auto-rp {listen [forward] | forward [listen]}

no ip pim auto-rp [{listen [forward] | forward [listen]}]

Syntax Description

listen

Specifies to listen to Auto-RP messages.

forward

Specifies to forward Auto-RP messages.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable listening and forwarding of Auto-RP messages:

switch(config)# ip pim auto-rp listen forward

This example shows how to disable listening and forwarding of Auto-RP messages:

switch(config)# no ip pim auto-rp listen forward

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim auto-rp mapping-agent

To configure the router as a IPv4 Protocol Independent Multicast (PIM) Auto-RP mapping agent that sends RP-Discovery messages, use the ip pim auto-rp mapping-agent command. To remove the mapping agent configuration, use the no form of this command.

ip pim auto-rp mapping-agent if-type if-number [scope ttl]

no ip pim auto-rp mapping-agent [if-type if-number] [scope ttl]

Syntax Description

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

scope ttl

(Optional) Specifies the time-to-live (TTL) value for the scope of Auto-RP Discovery messages. The range is from 1 to 255. The default is 32.

Note See the ip pim border command to explicitly define a router on the edge of a PIM domain rather than using the scope argument.


Defaults

The TTL is 32.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The ip pim send-rp-discovery command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to configure an Auto-RP mapping agent:

switch(config)# ip pim auto-rp mapping-agent ethernet 2/1

This example shows how to remove the Auto-RP mapping agent configuration:

switch(config)# no ip pim auto-rp mapping-agent ethernet 2/1

Related Commands

Command
Description

ip pim border

Configures a router to be on the edge of a PIM domain.

ip pim send-rp-discovery

Configures a router as an Auto-RP mapping agent.

show ip pim rp

Displays information about PIM RPs.


ip pim auto-rp mapping-agent-policy

To enable filtering of IPv4 IPv4 Protocol Independent Multicast (PIM) Auto-RP Discover messages, use the ip pim auto-rp mapping-agent-policy command. To disable filtering, use the no form of this command.

ip pim auto-rp mapping-agent-policy policy-name

no ip pim auto-rp mapping-agent-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command can be used on client routers where you can specify mapping agent addresses.

This command requires the Enterprise Services license.

Examples

This example shows how to enable a routing-rules policy to filter Auto-RP Discover messages:

switch(config)# ip pim auto-rp mapping-agent-policy my_mapping_agent_policy

This example shows how to disable filtering:

switch(config)# no ip pim auto-rp mapping-agent-policy

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim auto-rp rp-candidate

To configure an IPv4 Protocol Independent Multicast (PIM) Auto-RP candidate RP, use the ip pim auto-rp rp-candidate command. To remove an Auto-RP candidate RP, use the no form of this command.

ip pim auto-rp rp-candidate if-type if-number {group-list prefix} {[scope ttl] | [interval interval] | [bidir]}

no ip pim auto-rp rp-candidate [if-type if-number] [group-list prefix] {[scope ttl] | [interval interval] | [bidir]}

Syntax Description

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

group-list prefix

Specifies the group range used for the access list.

scope ttl

(Optional) Specifies a time-to-live (TTL) value for the scope of Auto-RP Announce messages. The range is from 1 to 255. The default is 32.

Note See the ip pim border command to explicitly define a router on the edge of a PIM domain rather than using the scope argument.

interval interval

(Optional) Specifies an Auto-RP Announce message transmission interval in seconds. The range is from 1 to 65,535. The default is 60.

bidir

(Optional) Specifies that group range is advertised in PIM bidirectional (Bidir) mode.


Defaults

The TTL is 32.
The Announce message interval is 60 seconds

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The scope, interval, and bidir keywords can be entered once and in any order.

The ip pim send-rp-announce command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a PIM Auto-RP candidate RP:

switch(config)# ip pim auto-rp rp-candidate ethernet 2/1 group-list 239.0.0.0/24

This example shows how to remove a PIM Auto-RP candidate RP:

switch(config)# no ip pim auto-rp rp-candidate ethernet 2/1 group-list 239.0.0.0/24

Related Commands

Command
Description

ip pim send-rp-announce

Configures a PIM Auto-RP candidate RP.

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim auto-rp rp-candidate-policy

To allow the Auto-RP mapping agents to filter IPv4 Protocol Independent Multicast (PIM) Auto-RP Announce messages that are based on a routing-rules policy, use the ip pim auto-rp rp-candidate-policy command. To disable filtering, use the no form of this command.

ip pim auto-rp rp-candidate-policy policy-name

no ip pim auto-rp rp-candidate-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to allow the Auto-RP mapping agents to filter Auto-RP Announce messages:

switch(config)# ip pim auto-rp rp-candidate-policy my_policy

This example shows how to disable filtering:

switch(config)# no ip pim auto-rp rp-candidate-policy

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim bidir-rp-limit

To configure the number of bidirectional (Bidir) RPs for use in IPv4 Protocol Independent Multicast (PIM), use the ip pim bidir-rp-limit command. To reset the number of RPs to the default, use the no form of this command.

ip pim bidir-rp-limit limit

no ip pim bidir-rp-limit limit

Syntax Description

limit

Limit for the number of Bidir RPs permitted in PIM. The range is from 0 to 8. The default is 6.


Defaults

The Bidir RP limit is 6.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(2)

This command was introduced.


Usage Guidelines

Because the maximum ordinal count of designated forwarders (DFs) is 8, the PIM and IPv6 PIM RP limits should be no more than 8.

To display the Bidir RP limit configured, use this command line:

switch(config)# show running-config | include bidir

This command requires the Enterprise Services license.

Examples

This example shows how to configure the number of Bidir RPs:

switch(config)# ip pim bidir-rp-limit 6

This example shows how to reset the number of Bidir RPs to the default:

switch(config)# no ip pim bidir-rp-limit 6

Related Commands

Command
Description

ipv6 pim bidir-rp-limit

Configures the number of Bidir RPs for PIM6.

show running-config

Displays information about the running-system configuration.


ip pim border

To configure an interface on an IPv4 Protocol Independent Multicast (PIM) border, use the ip pim border command. To remove an interface from a PIM border, use the no form of this command.

ip pim border

no ip pim border

Syntax Description

This command has no arguments or keywords.

Defaults

The interface is not on a PIM border.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure an interface on a PIM border:

switch(config)# ip pim border

This example shows how to remove an interface from a PIM border:

switch(config)# no ip pim border

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim bsr bsr-policy

To allow the bootstrap router (BSR) client routers to filter IPv4 Protocol Independent Multicast (PIM) BSR messages that are based on a routing-rules policy, use the ip pim bsr bsr-policy command. To disable filtering, use the no form of this command.

ip pim bsr bsr-policy policy-name

no ip pim bsr bsr-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to allow the BSR client routers to filter BSR messages:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim bsr bsr-policy my_bsr_policy

This example shows how to disable filtering:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim bsr bsr-policy

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim bsr forward

To listen to and forward IPv4 Protocol Independent Multicast (PIM) bootstrap router (BSR) and Candidate-RP messages, use the ip pim bsr forward command. To disable listening and forwarding, use the no form of this command.

ip pim bsr forward [listen]

no ip pim bsr [forward [listen]]

Syntax Description

forward

Specifies to Forward BSR and Candidate-RP messages.

listen

(Optional) Specifies to listen to BSR and Candidate-RP messages.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

A router configured as either a candidate RP or a candidate BSR will automatically listen to and forward all BSR protocol messages, unless an interface is configured with the domain border feature.

The ip pim bsr listen command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to forward BSR and Candidate-RP messages:

switch(config)# ip pim bsr forward

This example shows how to disable forwarding:

switch(config)# no ip pim bsr forward

Related Commands

Command
Description

ip pim bsr listen

Enables listening to and forwarding of BSR messages.

show ip pim rp

Displays information about PIM RPs.


ip pim bsr listen

To listen to and forward IPv4 Protocol Independent Multicast (PIM) bootstrap router (BSR) and Candidate-RP messages, use the ip pim bsr listen command. To disable listening and forwarding, use the no form of this command.

ip pim bsr listen [forward]

no ip pim bsr [listen [forward]]

Syntax Description

listen

Specifies to listen to BSR and Candidate-RP messages.

forward

(Optional) Specifies to forward BSR and Candidate-RP messages.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

A router configured as either a candidate RP or a candidate BSR will automatically listen to and forward all BSR protocol messages, unless an interface is configured with the domain border feature.

The ip pim bsr forward command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to listen to and forward BSR and Candidate-RP messages:

switch(config)# ip pim bsr listen forward

This example shows how to disable listening and forwarding:

switch(config)# no ip pim bsr listen forward

Related Commands

Command
Description

ip pim bsr forward

Enables listening to and forwarding of BSR messages.

show ip pim rp

Displays information about PIM RPs.


ip pim bsr rp-candidate-policy

To filter IPv4 Protocol Independent Multicast (PIM) bootstrap router (BSR) Candidate-RP messages that are based on a routing-rules policy, use the ip pim bsr rp-candidate-policy command. To disable filtering, use the no form of this command.

ip pim bsr rp-candidate-policy policy-name

no ip pim bsr rp-candidate-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to filter Candidate-RP messages:

switch(config)# ip pim bsr rp-candidate-policy my_bsr_rp_candidate_policy

This example shows how to disable message filtering:

switch(config)# no ip pim bsr rp-candidate-policy

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim bsr-candidate

To configure the router as an IPv4 Protocol Independent Multicast (PIM) bootstrap router (BSR) candidate, use the ip pim bsr-candidate command. To remove a router as a BSR candidate, use the no form of this command.

ip pim [bsr] bsr-candidate if-type if-number [hash-len hash-len] [priority priority]

no ip pim [bsr] bsr-candidate [if-type if-number] [hash-len hash-len] [priority priority]

Syntax Description

bsr

(Optional) Specifies the BSR protocol RP-distribution configuration.

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

hash-len hash-len

(Optional) Specifies the hash mask length used in BSR messages. The range is from 0 to 32. The default is 30.

priority priority

(Optional) Specifies the BSR priority used in BSR messages. The range is from 0 to 255. The default is 64.


Defaults

The hash mask length is 30.
The BSR priority is 64.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The interface specified is used to derive the BSR source IP address used in BSR messages.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a router as a BSR candidate:

switch(config)# ip pim bsr-candidate ethernet 2/2

This example shows how to remove a router as a BSR candidate:

switch(config)# no ip pim bsr-candidate

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim dr-priority

To configure the designated router (DR) priority that is advertised in IPv4 Protocol Independent Multicast (PIM) hello messages, use the ip pim dr-priority command. To reset the DR priority to the default, use the no form of this command.

ip pim dr-priority priority

no ip pim dr-priority [priority]

Syntax Description

priority

Priority value. The range is from 1 to 4294967295. The default is 1.


Defaults

The DR priority is 1.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure DR priority on an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim dr-priority 5

This example shows how to reset DR priority on an interface to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim dr-priority

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim flush-routes

To remove routes when the IPv4 Protocol Independent Multicast (PIM) process is restarted, use the ip pim flush-routes command. To leave routes in place, use the no form of this command.

ip pim flush-routes

no ip pim flush-routes

Syntax Description

This command has no arguments or keywords.

Defaults

The routes are not flushed.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display whether flush routes are configured, use this command line:

switch(config)# show running-config | include flush-routes

This command requires the Enterprise Services license.

Examples

This example shows how to remove routes when the PIM process is restarted:

switch(config)# ip pim flush-routes

This example shows how to leave routes in place when the PIM process is restarted:

switch(config)# no ip pim flush-routes

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ip pim hello-authentication ah-md5

To enable an MD5 hash authentication key in IPv4 Protocol Independent Multicast (PIM) hello messages, use the ip pim hello-authentication ah-md5 command. To disable hello-message authentication, use the no form of this command.

ip pim hello-authentication ah-md5 auth-key

no ip pim hello-authentication ah-md5 [auth-key]

Syntax Description

auth-key

MD5 authentication key. You can enter an unencrypted (cleartext) key, or one of these values followed by a space and the MD5 authentication key:

0—Specifies an unencrypted (cleartext) key

3—Specifies a 3-DES encrypted key

7—Specifies a Cisco Type 7 encrypted key

The key can be from 1 to 16 characters.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

Triple Data Encryption Standard (3-DES) is a strong form of encryption (168-bit) that allows sensitive information to be transmitted over untrusted networks. Cisco Type 7 encryption uses the algorithm from the Vigenère cipher.

This command requires the Enterprise Services license.

Examples

This example shows how to enable a 3-DES encrypted key for PIM hello-message authentication:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim hello-authentication-ah-md5 3 myauthkey

This example shows how to disable PIM hello-message authentication:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim hello-authentication-ah-md5

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim hello-interval

To configure the IPv4 Protocol Independent Multicast (PIM) hello-message interval on an interface, use the ip pim hello-interval command. To reset the hello interval to the default, use the no form of this command.

ip pim hello-interval interval

no ip pim hello-interval [interval]

Syntax Description

interval

Interval in milliseconds. The range is from 1 to 4294967295. The default is 30000.


Defaults

The PIM hello interval is 30,000 milliseconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure the PIM hello-message interval on an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim hello-interval 20000

This example shows how to reset the PIM hello-message interval on an interface to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim hello-interval

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim jp-policy

To filter IPv4 Protocol Independent Multicast (PIM) Join-Prune messages that are based on a routing-rules policy, use the ip pim jp-policy command. To disable filtering, use the no form of this command.

ip pim jp-policy policy-name

no ip pim jp-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to filter PIM Join-Prune messages:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim jp-policy my_jp_policy

This example shows how to disable filtering:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim jp-policy

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim log-neighbor-changes

To generate syslog messages that list the IPv4 Protocol Independent Multicast (PIM) neighbor state changes, use the ip pim log-neighbor-changes command. To disable messages, use the no form of this command.

ip pim log-neighbor-changes

no ip pim log-neighbor-changes

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to generate syslog message that list the PIM neighbor state changes:

switch(config)# ip pim log-neighbor-changes

This example shows how to disable logging:

switch(config)# no ip pim log-neighbor-changes

Related Commands

Command
Description

logging level ip pim

Configures the logging level of PIM messages.


ip pim neighbor-policy

To configure a routing-rules policy that determines which IPv4 Protocol Independent Multicast (PIM) neighbors should become adjacent, use the ip pim neighbor-policy command. To reset to the default, use the no form of this command.

ip pim neighbor-policy policy-name

no ip pim neighbor-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Forms adjacency with all neighbors.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a policy that determines which PIM neighbors should become adjacent:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim neighbor-policy

This example shows how to reset to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim neighbor-policy

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim register-policy

To filter of IPv4 Protocol Independent Multicast (PIM) Register messages that are based on a routing-rules policy, use the ip pim register-policy command. To disable message filtering, use the no form of this command.

ip pim register-policy policy-name

no ip pim register-policy [policy-name]

Syntax Description

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable filter PIM Register messages:

switch(config)# ip pim register-policy my_register_policy

This example shows how to disable message filtering:

switch(config)# no ip pim register-policy

Related Commands

Command
Description

show ip pim policy statistics register-policy

Displays statistics for PIM Register messages.


ip pim register-rate-limit

To configure a rate limit for IPv4 Protocol Independent Multicast (PIM) data registers, use the ip pim register-rate-limit command. To remove a rate limit, use the no form of this command.

ip pim register-rate-limit rate

no ip pim register-rate-limit [rate]

Syntax Description

rate

Rate in packets per second. The range is from 1 to 65,535.


Defaults

None

Command Modes

Global configuration (config)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure a rate limit for PIM data registers:

switch(config)# ip pim register-rate-limit 1000

This example shows how to remove a rate limit:

switch(config)# no ip pim register-rate-limit

Related Commands

Command
Description

show ip pim vrf detail

Displays information about the PIM configuration.


ip pim rp-address

To configure an IPv4 Protocol Independent Multicast (PIM) static RP address for a multicast group range, use the ip pim rp-address command. To remove a static RP address, use the no form of this command.

ip pim rp-address rp-address [group-list prefix] [bidir]

no ip pim rp-address rp-address [group-list prefix] [bidir]

Syntax Description

rp-address

IP address of a router which is the RP for a group range.

group-list prefix

(Optional) Specifies a group range for a static RP.

bidir

(Optional) Specifies to handle group range in PIM bidirectional (Bidir) mode.


Defaults

The group range is treated in ASM mode.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a PIM static RP address for a group range:

switch(config)# ip pim rp-address 192.0.2.33 group-list 224.0.0.0/9

This example shows how to remove a static RP address:

switch(config)# no ip pim rp-address 192.0.2.33 

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim rp-candidate

To configure the router as an IPv4 Protocol Independent Multicast (PIM) bootstrap router (BSR) RP candidate, use the ip pim rp-candidate command. To remove the router as an RP candidate, use the no form of this command.

ip pim [bsr] rp-candidate if-type if-number {group-list prefix} [priority priority] [interval interval] [bidir]

no ip pim [bsr] rp-candidate [if-type if-number] [group-list prefix] [priority priority] [interval interval] [bidir]

Syntax Description

bsr

(Optional) Specifies the BSR protocol RP-distribution configuration.

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

group-list prefix

Specifies a group range handled by the RP.

priority priority

(Optional) Specifies the RP priority used in Candidate-RP messages. The range is from 0 to 65,535. The default is 192.

interval interval

(Optional) Specifies the BSR message transmission interval in seconds. The range is from 1 to 65,535. The default is 60.

bidir

(Optional) Specifies the group range advertised in PIM bidirectional (Bidir) mode.


Defaults

The RP priority is 192.
The BSR message nterval is 60 seconds.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

We recommend that you configure the candidate RP interval to a minimum of 15 seconds.

This command requires the Enterprise Services license.

Examples

This example shows how to configure the router as a PIM BSR RP candidate:

switch(config)# ip pim rp-candidate e 2/11 group-list 239.0.0.0/24

This example shows how to remove the router as an RP candidate:

switch(config)# no ip pim rp-candidate

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ip pim send-rp-announce

To configure an IPv4 Protocol Independent Multicast (PIM) Auto-RP candidate RP, use the ip pim send-rp-announce command. To remove an Auto-RP candidate RP, use the no form of this command.

ip pim send-rp-announce if-type if-number {group-list prefix} {[scope ttl] | [interval interval] | [bidir]}

no ip pim send-rp-announce [if-type if-number] [group-list prefix] {[scope ttl] | [interval interval] | [bidir]}

Syntax Description

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

group-list prefix

Specifies a group range handled by the RP.

scope ttl

(Optional) Specifies a time-to-live (TTL) value for the scope of Auto-RP Announce messages. The range is from 1 to 255. The default is 32.

Note See the ip pim border command to explicitly define a router on the edge of a PIM domain rather than using the scope argument.

interval interval

(Optional) Specifies an Auto-RP Announce message transmission interval in seconds. The range is from 1 to 65,535. The default is 60.

bidir

(Optional) Specifies that the group range is advertised in PIM bidirectional (Bidir) mode.


Defaults

The TTL is 32.
The Auto-RP Announce message interval is 60 seconds.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The scope, interval, and bidir keywords can be entered once and in any order.

The ip pim auto-rp rp-candidate command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a PIM Auto-RP candidate RP:

switch(config)# ip pim send-rp-announce ethernet 2/1 group-list 239.0.0.0/24

This example shows how to remove a PIM Auto-RP candidate RP:

switch(config)# no ip pim send-rp-announce ethernet 2/1 group-list 239.0.0.0/24

Related Commands

Command
Description

ip pim auto-rp rp-candidate

Configures a PIM Auto-RP candidate RP.

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim send-rp-discovery

To configure the router as an IPv4 Protocol Independent Multicast (PIM) Auto-RP mapping agent that sends RP-Discovery messages, use the ip pim send-rp-discovery command. To remove the configuration, use the no form of this command.

ip pim send-rp-discovery if-type if-number [scope ttl]

no ip pim send-rp-discovery [if-type if-number] [scope ttl]

Syntax Description

if-type

Interface type. For more information, use the question mark (?) online help function.

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

scope ttl

(Optional) Specifies the time-to-live (TTL) value for the scope of Auto-RP Discovery messages. The range is from 1 to 255. The default is 32.

Note See the ip pim border command to explicitly define a router on the edge of a PIM domain rather than using the scope argument.


Defaults

The TTL is 32.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The ip pim auto-rp mapping-agent command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to configure an Auto-RP mapping agent:

switch(config)# ip pim send-rp-discovery ethernet 2/1

This example shows how to remove an Auto-RP mapping agent:

switch(config)# no ip pim send-rp-discovery ethernet 2/1

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.

ip pim auto-rp mapping-agent

Configures a router as an Auto-RP mapping agent.

ip pim border

Configures a router to be on the edge of a PIM domain.


ip pim sparse-mode

To enable IPv4 Protocol Independent Multicast (PIM) sparse mode on an interface, use the ip pim sparse-mode command. To disable PIM on an interface, use the no form of this command.

ip pim sparse-mode

no ip pim [sparse-mode]

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable PIM sparse mode on an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# ip pim sparse-mode

This example shows how to disable PIM on an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# no ip pim

Related Commands

Command
Description

show ip pim interface

Displays information about PIM-enabled interfaces.


ip pim ssm range

To configure group ranges for Source Specific Multicast (SSM), use the ip pim ssm range command. To reset the SSM group range to the default, use the no form of this command.

ip pim ssm range group

no ip pim ssm range [group]

Syntax Description

group

List of up to four group range prefixes.


Defaults

The SSM range is 232.0.0.0/8.

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a group range for SSM:

switch(config)# ip pim ssm range 239.128.1.0/24

This example shows how to reset the group range to the default:

switch(config)# no ip pim ssm range

Related Commands

Command
Description

show ip pim group-range

Displays information about PIM group ranges.


ip pim state-limit

To configure a maximum number of IPv4 Protocol Independent Multicast (PIM) state entries in the current virtual routing and forwarding (VRF) instance, use the ip pim state-limit command. To remove the limit on state entries, use the no form of this command.

ip pim state-limit max-states [reserved policy-name max-reserved]

no ip pim state-limit [max-states [reserved policy-name max-reserved]]

Syntax Description

max-states

Maximum number of (*, G) and (S, G) entries allowed in this VRF. The range is from 1 to 4294967295. The default is no limit.

reserved

(Optional) Specifies that a number of state entries are to be reserved for the routes specified in a policy map.

policy-name

(Optional) Routing-rules policy name.

max-reserved

(Optional) Maximum reserved (*, G) and (S, G) entries allowed in this VRF. Must be less than or equal to the maximum states allowed.


Defaults

None

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display commands where state limits are configured, use this command line:

switch(config)# show running-config | include state-limit

This command requires the Enterprise Services license.

Examples

This example shows how to configure a state entry limit with a number of state entries reserved for routes in a policy map:

switch(config)# ip pim state-limit 100000 reserved my_reserved_policy 40000

This example shows how to remove the limits on state entries:

switch(config)# no ip pim state-limit

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ip pim use-shared-tree-only

To create the IPv4 Protocol Independent Multicast (PIM) (*, G) state only (where no source state is created), use the ip pim use-shared-tree-only command. To remove the creation of the shared tree state only, use the no form of this command.

ip pim use-shared-tree-only [group]

no ip pim use-shared-tree-only [group]

Syntax Description

group

(Optional) Group range for creation of (*, G) state only.


Defaults

None

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to create the PIM (*, G) state only:

switch(config)# ip pim use-shared-tree-only

This example shows how to remove the creation of the (*, G) state only:

switch(config)# no ip pim use-shared-tree-only

Related Commands

Command
Description

show ip pim rp

Displays information about PIM RPs.


ipv6 mld access-group

To enable a Multicast Listener Discovery (MLD) routing-rules policy to control the multicast groups that hosts on a subnet serviced by an interface can join, use the ipv6 mld access-group command. To disable the routing-rules policy, use the no form of this command.

ipv6 [icmp] mld access-group policy-name

no ipv6 [icmp] mld access-group [policy-name]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable an MLD routing-rules policy:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld access-group my_access_group_policy
switch(config-if)# 

This example shows how to disable a routing-rules policy:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld access-group
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld group-timeout

To configure the Multicast Listener Discovery (MLD) group membership timeout, use the ipv6 mld group-timeout command. To reset to the default, use the no form of this command.

ipv6 [icmp] mld group-timeout time

no ipv6 [icmp] mld group-timeout [time]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

time

Time in seconds. The range is from 3 to 65,535. The default is 260.


Defaults

The group membership timeout is 260 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a group membership timeout:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld group-timeout 200
switch(config-if)# 

This example shows how to reset a group membership timeout to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld group-timeout
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld join-group

To statically bind a multicast group to an interface, use the ipv6 mld join-group command. To remove a group binding, use the no form of this command.

ipv6 mld join-group group [source source]

no ipv6 mld join-group group [source source]

Syntax Description

group

Multicast group IPv6 address.

source source

(Optional) Specifies a source IP address for an MLDv2 (S, G) channel.


Defaults

None

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

If you specify only the group address, the (*, G) state is created. If you specify the source address, the (S, G) state is created.


Note A source tree is built for the (S, G) state only if you enable MLDv2, which is the default.



Caution When you enter this command, the traffic generated is handled by the device CPU, not the hardware.

This command requires the Enterprise Services license.

Examples

This example shows how to statically bind a group to an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld join-group FFFE::1
switch(config-if)# 

This example shows how to remove a group binding from an interface:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld join-group FFFE::1
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld last-member-query-count

To configure the number of times that the software sends a Multicast Listener Discovery (MLD) query in response to a host leave message, use the ipv6 mld last-member-query-count command. To reset the query interval to the default, use the no form of this command.

ipv6 [icmp] mld last-member-query-count count

no ipv6 [icmp] mld last-member-query-count [count]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

count

Query count. The range is from 1 to 5. The default is 2.


Defaults

The query count is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a query count:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld last-member-query-count 3
switch(config-if)# 

This example shows how to reset a query count to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld last-member-query-count
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld last-member-query-response-time

To configure a query interval in which the software sends membership reports and then deletes the group state, use the ipv6 mld last-member-query-response-time command. To reset the interval to the default, use the no form of this command.

ipv6 [icmp] mld last-member-query-response-time interval

no ipv6 [icmp] mld last-member-query-response-time [interval]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

interval

Query interval in seconds. The range is from 1 to 25. The default is 1.


Defaults

The query interval is 1.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a query interval:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld last-member-query-response-time 3
switch(config-if)# 

This example shows how to reset a query interval to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld last-member-query-response-time
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld querier-timeout

To configure the Multicast Listener Discovery (MLD) querier timeout for MLDv1, use the ipv6 mld querier-timeout command. To reset the timeout to the default, use the no form of this command.

ipv6 [icmp] mld querier-timeout timeout

no ipv6 [icmp] mld querier-timeout [timeout]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

timeout

Timeout in seconds. The range is from 1 to 65,535. The default is 255.


Defaults

The querier timeout is 255 seconds

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The ipv6 mld query-timeout command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a querier timeout:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld querier-timeout 200
switch(config-if)# 

This example shows how to reset a querier timeout to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld querier-timeout
switch(config-if)# 

Related Commands

Command
Description

ipv6 mld query-timeout

Configures a querier timeout.

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld query-interval

To configure the Multicast Listener Discovery (MLD) interval between query transmissions, use the ipv6 mld query-interval command. To reset the interval to the default, use the no form of this command.

ipv6 [icmp] mld query-interval interval

no ipv6 [icmp] mld query-interval [interval]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

interval

Interval in seconds. The range is from 1 to 18,000. The default is 125.


Defaults

The query interval is 125 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a query interval:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld query-interval 100
switch(config-if)# 

This example shows how to reset a query interval to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld query-interval
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld query-max-response-time

To configure the Multicast Listener Discovery (MLD) maximum response time for query messages, use the ipv6 mld query-max-response-time command. To reset the response time to the default, use the no form of this command.

ipv6 [icmp] mld query-max-response-time time

no ipv6 [icmp] mld query-max-response-time [time]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

time

Time in seconds. The range is from 1 to 8387. The default is 10.


Defaults

The maximum query response time is 10 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a query maximum response time:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld query-max-response-time 15
switch(config-if)# 

This example shows how to reset a query maximum response time to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld query-max-response-time
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld query-timeout

To configure the Multicast Listener Discovery (MLD) querier timeout for MLDv1, use the ipv6 mld query-timeout command. To reset the timeout to the default, use the no form of this command.

ipv6 [icmp] mld query-timeout timeout

no ipv6 [icmp] mld query-timeout [timeout]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

timeout

Timeout in seconds. The range is from 1 to 65,535. The default is 255.


Defaults

The querier timeout is 255 seconds.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

The ipv6 mld querier-timeout command is an alternative form of this command.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a querier timeout:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld query-timeout 200
switch(config-if)# 

This example shows how to reset a querier timeout to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld query-timeout
switch(config-if)# 

Related Commands

Command
Description

ipv6 mld querier-timeout

Configures a querier timeout.

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld report-link-local-groups

To enable Multicast Listener Discovery (MLD) to send reports for link-local groups, use the ipv6 mld report-link-local-groups command. To disable sending reports to link-local groups, use the no form of this command.

ipv6 [icmp] mld report-link-local-groups

no ipv6 [icmp] mld report-link-local-groups

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable sending reports to link-local groups:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld report-link-local-groups
switch(config-if)# 

This example shows how to disable sending reports to link-local groups:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld report-link-local-groups
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld report-policy

To enable an access policy that is based on a routing-rules policy for Multicast Listener Discovery (MLD) reports, use the ipv6 mld report-policy command. To disable the routing-rules policy, use the no form of this command.

ipv6 [icmp] mld report-policy policy-name

no ipv6 [icmp] mld report-policy [policy-name]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

policy-name

Routing-rules policy name.


Defaults

Disabled

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to enable an access policy for MLD reports:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld report-policy my_report_policy
switch(config-if)# 

This example shows how to disable an access policy for MLD reports:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld report-policy
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld robustness-variable

To configure a Multicast Listener Discovery (MLD) robustness count that you can tune to reflect the expected packet loss on a congested network, use the ipv6 mld robustness-variable command. To reset the count to the default, use the no form of this command.

ipv6 [icmp] mld robustness-variable count

no ipv6 [icmp] mld robustness-variable [count]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

count

Robustness count. The range is from 1 to 7. The default is 2.


Defaults

The robustness count is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a robustness count:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld robustness-variable 3
switch(config-if)# 

This example shows how to reset a robustness count to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld robustness-variable
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld ssm-translate

To translate Multicast Listener Discovery (MLD) version 1 reports to create (S, G) state entries so that the router treats them as MLDv2 membership reports, use the ipv6 mld ssm-translate command. To remove the translation, use the no form of this command.

ipv6 [icmp] mld ssm-translate group source

no ipv6 [icmp] mld ssm-translate group source

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

group

IPv6 multicast group range. By default, the group prefix range is FF3x/96. To modify the IPv6 Protocol Independent Multicast (PIM6) SSM range, see the ipv6 pim ssm range command.

source

IPv6 multicast source address.


Defaults

None

Command Modes

Global configuration (config)
VRF configuration (config-vrf)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

To display SSM translation commands, use this command line:

switch(config)# show running-config | include ssm-translation

This command requires the Enterprise Services license.

Examples

This example shows how to configure a translation:

switch(config)# ipv6 mld ssm-translate FF30::0/16 2001:0DB8:0:ABCD::1

This example shows how to remove a translation:

switch(config)# no ipv6 mld ssm-translate FF30::0/16 2001:0DB8:0:ABCD::1

Related Commands

Command
Description

show running-config

Displays information about the running-system configuration.


ipv6 mld startup-query-count

To configure the query count used when the Multicast Listener Discovery (MLD) process starts up, use the ipv6 mld startup-query-count command. To reset the query count to the default, use the no form of this command.

ipv6 [icmp] mld startup-query-count count

no ipv6 [icmp] mld startup-query-count [count]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

count

Query count. The range is from 1 to 10. The default is 2.


Defaults

The query count is 2.

Command Modes

Interface configuration (config-if)

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure a query count:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld startup-query-count 3
switch(config-if)# 

This example shows how to reset a query count to the default:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld startup-query-count
switch(config-if)# 

Related Commands

Command
Description

show ipv6 mld interface

Displays information about ICMPv6 interfaces.


ipv6 mld startup-query-interval

To configure the query interval used when the Multicast Listener Discovery (MLD) process starts up, use the ipv6 mld startup-query-interval command. To reset the query interval to the default, use the no form of this command.

ipv6 [icmp] mld startup-query-interval interval

no ipv6 [icmp] mld startup-query-interval [interval]

Syntax Description

icmp

(Optional) Specifies ICMPv6 commands.

interval

Query interval in seconds. The range is from 1 to 18,000. The default is 31.


Defaults

The startup query interval is 31 seconds.