I Commands

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

ip igmp access-group

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command.

This command requires the Enterprise Services license.

Examples

This example shows how to enable a route-map 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 route-map policy:

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

 
Related Commands

Command
Description

Displays IGMP information about the interface.

ip igmp enforce-router-alert

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable the enforce router alert option check:

switch(config)# ip igmp enforce-router-alert
 

This example shows how to disable the enforce router alert option check:

switch(config)# no ip igmp enforce-router-alert
 

 
Related Commands

Command
Description

Displays information about the IGMP running-system configuration.

ip igmp event-history

form of this command.

 
Syntax Description

Configures the IGMP CLI event history buffer size.

errors

Configures the error event history buffer size.

Configures the IGMP group debug event history buffer size.

Configures the IGMP group-event event history buffer size.

Configures the IGMP HA event history buffer size.

Configures the IGMP IGMP-internal event history buffer size.

Configures the IGMP interface debug event history buffer size.

Configures the IGMP interface-event event history buffer size.

msgs

Configures the message event history buffer size.

Configures the IGMP mtrace event history buffer size.

Configures the IGMP policy event history buffer size.

statistics

Configures the statistics event history buffer size.

Configures the IGMP VRF event history buffer size.

Specifies the size of the buffer to allocate.

.

 
Defaults

All history buffers are allocated as small.

 
Command Modes

Any command mode

 
Supported User Roles

vdc-operator

 
Command History

Release
Modification

4.1(2)

This command was introduced.

4.1(3)

.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IGMP HA event history buffer size:

switch(config)# ip igmp event-history ha size large
switch(config)#

 
Related Commands

Command
Description

Clears the contents of IGMP event history buffers.

Displays information in the IGMP event history buffers.

Displays information about the IGMP running-system configuration.

ip igmp flush-routes

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The routes are not flushed.

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about the running-system configuration.

ip igmp group-timeout

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp immediate-leave

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The immediate leave feature is disabled.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.1(3)

This command was introduced.

 
Usage Guidelines

command only when there is one receiver behind the interface for a given group.

This command does not require a license.

Examples

This example shows how to enable the immediate leave feature:

switch(config)# interface ethernet 2/2
switch(config-if)# ip igmp immediate-leave
 

This example shows how to disable the immediate leave feature:

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

 
Related Commands

Command
Description

Displays IGMP information about the interface.

ip igmp join-group

form of this command.

}

}

 
Syntax Description

Multicast group IP address.

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

Specifies the route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(1)

.

 
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.

command. You can specify the group prefix and source prefix.

Beginning with Cisco NX-OS Release 5.2, if ip igmp join-group is configured under any interface, other interfaces will be removed from the outgoing interface list (OIL) resulting in multicast packet loss. The command ip igmp join-group must be only used for testing and must not be present on a production device. Use the ip igmp static-oif command instead.


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

Displays IGMP information about the interface.

ip igmp static-oif

Statically binds a multicast group to the OIF.

ip igmp last-member-query-count

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp last-member-query-response-time

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp query-interval

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp query-max-response-time

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp query-timeout

form of this command.

]

 
Syntax Description

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

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 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 query 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

Displays IGMP information about the interface.

ip igmp report-link-local-groups

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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

Displays IGMP information about the interface.

ip igmp report-policy

form of this command.

]

 
Syntax Description

Route-map policy name. The policy name is case sensitive alphanumeric, maximum size is 32 characters.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command to filter incoming messages. You can configure the route map to prevent a state from being created in the multicast routing table.

command.

command. You can specify the group prefix, group range, and source prefix to filter messages.

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

Displays IGMP information about the interface.

ip igmp robustness-variable

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp snooping (Global)

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

If the global configuration of IGMP snooping is disabled, 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

Displays IGMP snooping information.

ip igmp snooping (VLAN)

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

VLAN configuration (config-vlan) mode (until Cisco NX-OS Release 5.1)

Configure VLAN (config-vlan-config) mode (Since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

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

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

This command does not require a license.

Examples

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

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping
switch(config-vlan-config)# ]
 

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

switch(config)# vlan configuration 10
switch(config-vlan)# no ip igmp snooping
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping event-history

form of this command.

 
Syntax Description

Clears the virtual port channel (vPC) event history buffer.

Clears the IGMP snooping internal event history buffer.

Clears the Multicast Forwarding Distribution Module (MFDM) event history buffer.

Clears the MFDM sum event history buffer.

Clears the VLAN event history buffer.

Clears the VLAN-event event history buffer.

Specifies the size of the buffer to allocate.

.

 
Defaults

All history buffers are allocated as small.

 
Command Modes

Any command mode

 
Supported User Roles

vdc-operator

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the IGMP snooping VLAN event history buffer size:

switch(config)# ip igmp snooping event-history vlan size large
switch(config)#
 

 
Related Commands

Command
Description

Clears the contents of the IGMP snooping event history buffers.

Displays information in the IGMP snooping event history buffers.

Displays information about the IGMP running-system configuration.

ip igmp snooping explicit-tracking

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

VLAN configuration (config-vlan) (until Cisco NX-OS Release 5.1)

Configure VLAN (config-vlan-config) mode (Since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher).

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

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

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

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

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping fast-leave

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

VLAN configuration (config-vlan) mode (until Cisco NX-OS Release 5.1)

Configure VLAN (config-vlan-config) mode (Since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher).

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

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.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

This command does not require a license.

Examples

This example shows how to enable support of IGMPv2 hosts:

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

This example shows how to disable support of IGMPv2 hosts:

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping group-timeout

form of this command.

group-timeout timeout | never

group-timeout timeout

 
Syntax Description

Timeout in minutes. The range is from 1 to 10080.

Never expire ports from group membership.

 
Defaults

None

 
Command Modes

Global Configuration mode

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure group membership timeout in all VLANs:

switch(config)# ip igmp snooping group-timeout 100
switch(config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping group-timeout (VLAN)

form of this command.

group-timeout timeout | never

group-timeout timeout

 
Syntax Description

Timeout in minutes. The range is from 1 to 10080.

Never expire ports from group membership.

 
Defaults

None

 
Command Modes

VLAN configuration (config-vlan) mode (until Cisco NX-OS Release 5.1)

Configure VLAN (config-vlan-config) mode (Since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher).

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.1(2)

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.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

This command does not require a license.

Examples

This example shows how to configure group membership timeout in all VLANs:

switch(config)# ip igmp snooping group-timeout 100
switch(config)#
 

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping last-member-query-interval

form of this command.

]

 
Syntax Description

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) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

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

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

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

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping link-local-groups-suppression

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

Global configuration (config)

VLAN configuration (config-vlan) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

If this setting is disabled on the entire device, it is disabled on all VLANs on the device, irrespective of the specific VLAN setting.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

This example shows how to enable suppression of IGMP reports from link-local groups:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping link-local-groups-suppression
switch(config-vlan-config)#
 

This example shows how to disable suppression of IGMP reports from link-local groups:

switch(config)# vlan configuration 10
switch(config-vlan-config)# no ip igmp snooping link-local-groups-suppression
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping max-gq-miss

form of this command.

count

 
Syntax Description

Specifies the IGMP snooping count. The range is from 3 to 5 queries. The default is 3 queries.

 
Defaults

3

 
Command Modes

Global configuration mode.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

6.2(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the maximum number of general query misses permitted for IGMP snooping:

switch(config)# config t
switch(config)# ip igmp snooping max-gq-miss 5
switch(config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

 

ip igmp snooping mrouter interface

form of this command.

 
Syntax Description

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

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) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

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

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

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

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

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

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping optimised-multicast-flood

form of this command.

optimised-multicast-flood

optimised-multicast-flood

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

VLAN configuration (config-vlan) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

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

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

This example shows how to configure OMF on the VLAN:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping optimised-multicast-flood
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping proxy

form of this command.

proxy general-queries

proxy general-queries

 
Syntax Description

Specifies proxy for general queries.

 
Defaults

None

 
Command Modes

Global Configuration mode

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure proxy for general queries:

switch(config)# ip igmp snooping proxy general-queries
switch(config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping proxy (VLAN)

form of this command.

proxy general-queries

proxy general-queries

 
Syntax Description

Specifies proxy for general queries.

 
Defaults

None

 
Command Modes

VLAN configuration (config-vlan) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

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

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

This example shows how to configure proxy for general queries:

switch(config)# ip igmp snooping proxy general-queries
switch(config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping querier

form of this command.

]

 
Syntax Description

Querier IP address.

 
Defaults

None

 
Command Modes

VLAN configuration (config-vlan) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

This example shows how to configure a snooping querier:

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

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

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping query-interval

form of this command.

 
Syntax Description

Interval in seconds. The range is from 1 to 18000.

 
Defaults

125 seconds

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the interval between query transmission:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping query-interval 3
switch(config-vlan-config)# er than mrt, configure query-max-response-time
first
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping query-max-response-time

form of this command.

 
Syntax Description

Time in seconds. The range is from 1 to 25.

 
Defaults

10 seconds

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the MRT for query messages:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping query-max-response-time 20
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping querier-timeout

form of this command.

 
Syntax Description

Time in seconds. The range is from 1to 65535.

 
Defaults

255 seconds

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the querier timeout for IGMPv2:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping querier-timeout 3
switch(config-vlan-config)#
 

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping report-suppression

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

VLAN configuration (config-vlan) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

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.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

This command does not require a license.

Examples

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

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

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

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping robustness-variable

form of this command.

 
Syntax Description

Count value. The range is from 1 to 7.

 
Defaults

2

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the configure the RFC defined robustness variable:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping robustness-variable 4
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping startup-query-count

form of this command.

 
Syntax Description

Count value. The range is from 1 to 10.

 
Defaults

None

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the number of queries sent at startup:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping startup-query-count 4
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping startup-query-interval

form of this command.

 
Syntax Description

Interval in seconds. The range is from 1 to 18000.

 
Defaults

None

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the query interval at startup:

switch(config)# vlan configuration 10
switch(config-vlan-config)# ip igmp snooping startup-query-interval 4
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping static-group

form of this command.

 
Syntax Description

Group IP address.

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

Specifies an interface for the static group.

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

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) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

Examples

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

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

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

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping version

form of this command.

 
Syntax Description

Version number value. The range is from 2 to 3.

 
Defaults

None

 
Command Modes

VLAN configuration (config-vlan)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure IGMP version number for VLAN:

switch(config-vlan-config)# ip igmp snooping version 3
switch(config-vlan-config)#

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp snooping v3-report-suppression (Global)

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays IGMP snooping information.

ip igmp snooping v3-report-suppression (VLAN)

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Enabled

 
Command Modes

VLAN configuration (config-vlan) until Cisco NX-OS Release 5.1.

Configure VLAN (config-vlan-config) since Cisco NS-OS Release 5.1(1). You cannot configure this command in the VLAN configuration mode in Cisco Release NX-OS 5.1 and higher.

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

NX-OS 5.1(1)

The mode to configure this command on a VLAN changed to the configure VLAN mode (config-vlan-config)#. You can no longer configure this command in the VLAN configuration mode (config-vlan)#.

4.0(3)

This command was introduced.

 
Usage Guidelines

If this setting is disabled for the device, which is the default value, it is disabled for all VLANs, irrespective of how you set this value for an individual VLAN. However, once you set the global setting to enabled, the settings for all the VLANs are enabled by default.

See the Layer2 Command Reference Guide for information on entering the Configure VLAN mode by using the vlan configuration command.

This command does not require a license.

Examples

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

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

This example shows how to remove IGMPv3 report suppression on specified VLANs:

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

 
Related Commands

Command
Description

Displays IGMP snooping information.

ip igmp ssm-translate

form of this command.

 
Syntax Description

command.

IP multicast address source.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about the running-system configuration.

ip igmp startup-query-count

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp startup-query-interval

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip igmp state-limit

form of this command.

]

]]

 
Syntax Description

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

(Optional) Specifies to use the route-map 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

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

Displays IGMP information about the interface.

ip igmp static-oif

form of this command.

}

}

 
Syntax Description

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

(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.

Specifies the route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(1)

.

 
Usage Guidelines

command.

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

Displays information about the IGMP local group membership.

ip igmp version

form of this command.

]

 
Syntax Description

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

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

Displays IGMP information about the interface.

ip mroute

form of this command.

]

]

 
Syntax Description

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

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

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

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

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

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

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

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

(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

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

Displays information about multicast routes.

ip msdp description

form of this command.

]

 
Syntax Description

IP address of MSDP peer.

Text description.

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about MSDP peers.

ip msdp event-history

form of this command.

 
Syntax Description

Configures the CLI event history buffer.

Configures the peer-events event history buffer.

Configures the MSDP internal event history buffer.

Configures the routes event history buffer.

Configures the TCP event history buffer.

Specifies the size of the buffer to allocate.

.

 
Defaults

All history buffers are allocated as small.

 
Command Modes

Any command mode

 
Supported User Roles

vdc-operator

 
Command History

Release
Modification

4.1(2)

This command was introduced.

4.1(3)

Changed the buffer type arguments to required.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the size of the MSDP event history buffer:

switch(config)# ip msdp event-history events size medium
switch(config)#

 
Related Commands

Command
Description

Clears information in the IPv4 MRIB event history buffers.

Displays information in the IPv4 MRIB event history buffers.

Displays information about the running-system MSDP configuration.

ip msdp flush-routes

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The routes are not flushed.

 
Command Modes

Global configuration (config)

 
Supported User Roles

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 configure flushing routes when the MSDP process is restarted:

switch(config)# ip msdp flush-routes
 

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

switch(config)# no ip msdp flush-routes
 

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ip msdp group-limit

form of this command.

 
Syntax Description

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

Specifies the prefix to match sources against.

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about the MSDP learned sources and group limit.

ip msdp keepalive

form of this command.

]

 
Syntax Description

IP address of an MSDP peer.

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

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

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

Displays information about MSDP peers.

ip msdp mesh-group

form of this command.

]

 
Syntax Description

IP address of an MSDP peer in a mesh group.

Name of the mesh group.

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about MSDP mesh groups.

ip msdp originator-id

form of this command.

]

 
Syntax Description

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

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

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

Displays a summary of MDSP information.

ip msdp password

form of this command.

]

 
Syntax Description

IP address of an MSDP peer.

MD5 password.

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays MDSP peer information.

ip msdp peer

form of this command.

]

]

 
Syntax Description

IP address of the MSDP peer.

Configures a local IP address for a TCP connection.

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

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

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

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

The 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

Displays a summary of MSDP information.

ip msdp reconnect-interval

form of this command.

]

 
Syntax Description

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

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

Displays information about MSDP peers.

ip msdp sa-interval

form of this command.

]

 
Syntax Description

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

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

Displays information about the running-system configuration.

ip msdp sa-limit

form of this command.

]

 
Syntax Description

IP address of an MSDP peer.

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

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

Displays information about MSDP peers.

ip msdp sa-policy in

form of this command.

 
Syntax Description

IP address of an MSDP peer.

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about MSDP peers.

ip msdp sa-policy out

form of this command.

 
Syntax Description

IP address of an MSDP peer.

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about MSDP peers.

ip msdp shutdown

form of this command.

 
Syntax Description

IP address of an MSDP peer.

 
Defaults

Enabled

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about MSDP peers.

ip pim anycast-rp

form of this command.

 
Syntax Description

Anycast-RP address of the peer.

Address of RP in the Anycast-RP set.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about PIM RPs.

ip pim auto-rp listen

form of this command.

]}

]}]

 
Syntax Description

Specifies to listen to Auto-RP messages.

Specifies to forward Auto-RP messages.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about PIM RPs.

ip pim auto-rp mapping-agent

form of this command.

]

]

 
Syntax Description

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

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

(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.

argument.

 
Defaults

The TTL is 32.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

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

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

Configures a router as an Auto-RP mapping agent.

Displays information about PIM RPs.

ip pim auto-rp mapping-agent-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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.

command in a route-map policy.

This command requires the Enterprise Services license.

Examples

This example shows how to enable a route-map 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

Displays information about PIM RPs.

ip pim auto-rp rp-candidate

form of this command.

]}

]}

 
Syntax Description

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

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

Specifies the group range used for the access list.

(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.

argument.

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

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

 
Defaults

The Announce message interval is 60 seconds.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

keywords can be entered once and in any order.

command is an alternative form of this command.

Using a route map, you can add group ranges that this auto RP candidate-RP can serve.


Note Use the same configuration guidelines for the route-map auto-rp-range that you used when you create a route map for static RPS.

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

Configures a PIM Auto-RP candidate RP.

Displays information about PIM-enabled interfaces.

ip pim auto-rp rp-candidate-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy.

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

Displays information about PIM RPs.

ip pim bidir-rp-limit

form of this command.

 
Syntax Description

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

VRF configuration (config-vrf)

 
Supported User Roles

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

Configures the number of Bidir RPs for PIM6.

Displays information about the running-system configuration.

ip pim border

form of this command.

 
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

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

Displays information about PIM-enabled interfaces.

ip pim bsr bsr-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy.

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

Displays information about PIM RPs.

ip pim bsr-candidate

form of this command.

]

]

 
Syntax Description

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

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

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

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

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

 
Defaults

The BSR priority is 64.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about PIM RPs.

ip pim bsr forward

form of this command.

]

]]

 
Syntax Description

Specifies to Forward BSR and Candidate-RP messages.

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

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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.

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

Enables listening to and forwarding of BSR messages.

Displays information about PIM RPs.

ip pim bsr listen

form of this command.

]

]]

 
Syntax Description

Specifies to listen to BSR and Candidate-RP messages.

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

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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.

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

Enables listening to and forwarding of BSR messages.

Displays information about PIM RPs.

ip pim bsr rp-candidate-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy.

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

Displays information about PIM RPs.

ip pim dr-priority

form of this command.

]

 
Syntax Description

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

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 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 the 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

Displays information about PIM-enabled interfaces.

ip pim event-history

form of this command.

 
Syntax Description

assert-receive

Configures the assert receive event history buffer.

bidir

Configures the Bidir event history buffer.

cli

Configures the CLI event history buffer.

hello

Configures the hello event history buffer.

join-prune

Configures the join-prune event history buffer.

null-register

Configures the null register event history buffer.

packet

Configures the packet event history buffer.

pim-internal

Configures the PIM internal event history buffer.

rp

Configures the rendezvous point (RP) event history buffer.

vrf

Configures the virtual routing and forwarding (VRF) event history buffer.

Specifies the size of the buffer to allocate.

.

 
Defaults

All history buffers are allocated as small.

 
Command Modes

Any command mode

 
Supported User Roles

vdc-operator

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the size of the PIM hello event history buffer:

switch(config)# ip pim event-history hello size medium
switch(config)#

 
Related Commands

Command
Description

Clears information in the IPv4 PIM event history buffers.

Displays information in the IPv4 PIM event history buffers.

Displays information about the running-system PIM configuration.

ip pim flush-routes

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The routes are not flushed.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about the running-system configuration.

ip pim hello-authentication ah-md5

form of this command.

]

 
Syntax Description

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

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

Displays information about PIM-enabled interfaces.

ip pim hello-interval

form of this command.

]

 
Syntax Description

Interval in milliseconds. The range is from 1000 to 18724286. The default is 30000.

Note We do not support aggressive hello intervals. Any value below 30000 milliseconds is an aggressive PIM hello-interval value.

 
Defaults

The PIM hello interval is 30,000 milliseconds.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.2

Changed the minimum value from 1 millisecond to 1000 milliseconds and maximum value from 4294967295 to 18724286.

4.0(1)

This command was introduced.

 
Usage Guidelines

We recommend that you use BFD for PIM instead of non-default timers.

.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

Displays information about PIM-enabled interfaces.

ip pim jp-policy

form of this command.

]

]

 
Syntax Description

Route-map policy name.

Specifies that the system applies a filter only for incoming messages.

Specifies that the system applies a filter only for outgoing messages.

 
Defaults

Disabled; no filter is applied for either incoming or outgoing messages.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(3)

parameters were added.

 
Usage Guidelines

keyword.

command to filter incoming messages. You can configure the route map to prevent state from being created in the multicast routing table.

command.

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

Displays information about PIM-enabled interfaces.

ip pim log-neighbor-changes

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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 a syslog message that lists 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

Configures the logging level of PIM messages.

ip pim neighbor-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Forms adjacency with all neighbors.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy to specify which groups to become adjacent to.

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

Displays information about PIM-enabled interfaces.

ip pim pre-build-spt

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Joins are triggered only if the OIF list is not empty.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.2(3)

This command was introduced.

 
Usage Guidelines

command.

By default, PIM (S,G) joins are triggered upstream only if the OIF-list for the (S,G) is not empty. It is useful in certain scenarios—for example, on the virtual port-channel (vPC) nonforwarding router—to prebuild the SPTs and maintain the (S,G) states even when the system is not forwarding on these routes. Prebuilding the SPT ensures faster convergence when a vPC failover occurs.

When you are running virtual port channels (vPCs), enabling this feature causes both vPC peer switches to join the SPT, even though only one vPC peer switch actually routes the multicast traffic into the vPC domain. This behavior results in the multicast traffic passing over two parallel paths from the source to the vPC switch pair, consuming bandwidth on both paths. Additionally, when both vPC peer switches join the SPT, one or more upstream devices in the network may be required to perform additional multicast replications to deliver the traffic on both parallel paths toward the receivers in the vPC domain.

This command requires the Enterprise Services license.

Examples

This example shows how to prebuild the SPT in the absence of receivers:

switch(config)# vrf context Enterprise
switch(config-vrf)# ip pim pre-build-spt
switch(config-vrf)#
 

 
Related Commands

Command
Description

Displays information about PIM routes.

ip pim register-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy to specify the group or group and source addresses whose register messages that should be filtered.

This command requires the Enterprise Services license.

Examples

This example shows how to enable filtering of 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

Displays statistics for PIM Register messages.

ip pim register-rate-limit

form of this command.

]

 
Syntax Description

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

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

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

Displays information about the PIM configuration.

ip pim register-until-stop

To configure the device to continue to send PIM data registers from the first-hop router until a PIM register-stop message is received, use the ip pim register-until-stop command. To return to default setting, use the no form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.2(1)

This command was introduced.

 
Usage Guidelines

Must have PIM enabled.

This command does not require a license.

Examples

This example shows how to configure send data registers till register stop is received:

switch(config)# ip pim register-until-stop

 
Related Commands

Command
Description

Displays the current operating information about the PIM configuration.

ip pim rp-address

form of this command.

]

]

 
Syntax Description

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

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

override

(Optional) Specifies the RP address. The RP address overrides the dynamically learned RP addresses.

(Optional) Specifies a route-map policy name.

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

 
Defaults

The group range is treated in ASM mode.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

5.1(1)

Added the keyword override.

4.0(1)

This command was introduced.

4.2(1)

.

 
Usage Guidelines

command.

You can use this override provision, if you want the static RPs always to override the dynamic ones.

This command requires the Enterprise Services license.

Examples

This example shows how to configure a PIM static RP address for a serving group range and to override any dynamically learned (through BSR) RP addresses:

switch(config)# ip pim rp-address 1.1.1.1 group-list 225.1.0.0/16 override
 

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

Displays information about PIM RPs.

ip pim rp-candidate

form of this command.

]

]

 
Syntax Description

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

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

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

Specifies a group range handled by the RP.

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

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

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

 
Defaults

The BSR message interval is 60 seconds.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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 be a minimum of 15 seconds.

Using this route map, you can add a range of group lists that this candidate-RP can serve.

This command requires the Enterprise Services license.


Note Use the same configuration guidelines for the route-map auto-rp-range that you used when you created a route map for static RPS.

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

Displays information about PIM RPs.

ip pim send-rp-announce

form of this command.

]}

]}

 
Syntax Description

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

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

Specifies a group range handled by the RP.

(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.

argument.

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

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

 
Defaults

The Auto-RP Announce message interval is 60 seconds.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

keywords can be entered once and in any order.

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.

Displays information about PIM-enabled interfaces.

ip pim send-rp-discovery

form of this command.

]

]

 
Syntax Description

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

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

(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.

argument.

 
Defaults

The TTL is 32.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

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

Displays information about PIM RPs.

Configures a router as an Auto-RP mapping agent.

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

ip pim sg-expiry-timer

form of the command.

]

]

 
Syntax Description

(Optional) Specifies sparse mode.

Expiry-timer interval. The range is from 180 to 57600 seconds.

(Optional) Specifies S,G values to which the timer applies.

 
Defaults

The default is 180 seconds.

The timer applies to all (S,G) multicast routes in the routing table.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.2(2)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to configure the expiry interval to 300 seconds for all (S,G) multicast routes:

switch(config)# vrf context Enterprise
switch(config-vrf)# ip pim sg-expiry-timer 300
switch(config-vrf)#
 

 
Related Commands

Command
Description

Displays information about the PIM configuration.

ip pim sparse-mode

form of this command.

]

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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

Displays information about PIM-enabled interfaces.

ip pim spt-threshold infinity

form of this command.

]

 
Syntax Description

Route-map name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.1(2)

was added and a route-map name is used to define groups.

 
Usage Guidelines

The match ip multicast command is the only match command that is evaluated in the route map. You can specify the group prefix to filter messages with the match ip multicast command.

You must have enabled PIM before you can use this command.


Note This command is not supported for virtual port channels (vPCs).


Note Prior to Cisco NX-OS Release 5.2(3), the route map specified by the ip pim spt-threshold infinity group-list route-map command was limited to 50 sequence lines. Starting in Cisco NX-OS Release 5.2(3), the number of sequence lines in the route map has increased to 500. If you specify more than 500 sequence lines in a route map, they are not functional.

This command requires the Enterprise Services license.

Examples

This example shows how to create the PIM (*, G) state only for the group prefixes defined in my_group_map:

switch(config)# ip pim spt-threshold infinity group-list my_group_map
 

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

switch(config)# no ip pim spt-threshold infinity
 

 
Related Commands

Command
Description

Displays information about PIM RPs.

ip pim ssm policy

form of this command.

 
Syntax Description

Route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

The SSM range is 232.0.0.0/8.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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 policy my_ssm_policy
 

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

switch(config)# no ip pim ssm policy my_ssm_policy
 

 
Related Commands

Command
Description

Displays information about PIM group ranges.

ip pim ssm range

keyword.

}

}

 
Syntax Description

List of up to four group range prefixes.

Removes all group ranges.

Specifies the route-map policy name.

 
Defaults

The SSM range is 232.0.0.0/8.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.1(2)

was added.

4.2(1)

.

 
Usage Guidelines

command.

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 none
 

This example shows how to remove all group ranges:

switch(config)# ip pim ssm range none
 

 
Related Commands

Command
Description

Displays information about PIM group ranges.

ip pim state-limit

form of this command.

]

]]

 
Syntax Description

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

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

(Optional) Route-map policy name.

(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

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about the running-system configuration.

ip pim use-shared-tree-only

form of this command.

]

 
Syntax Description

Route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.1(2)

was added and a route-map policy name was used to define groups.

 
Usage Guidelines

command in a route-map policy to specify the groups where shared trees should be enforced.

You must have enabled PIM before you can use this command.


Note This command is not supported for virtual port channels (vPCs).

This command requires the Enterprise Services license.

Examples

This example shows how to create the PIM (*, G) state only for the group prefixes defined in my_group_policy:

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

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

Displays information about PIM RPs.

ip routing multicast event-history

form of this command.

 
Syntax Description

Configures the CLI event history buffer.

Configures the Multicast Forwarding Distribution Module (MFDM) debug event history buffer.

Configures the (MFDM) non periodic events event history buffer.

Configures the MFDM sum event history buffer.

Configures the RIB event history buffer.

Configures the virtual routing and forwarding (VRF) event history buffer.

Specifies the size of the buffer to allocate.

.

 
Command Default

All history buffers are allocated as small.

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.1(2)

This command was introduced.

4.2(1)

.

 
Usage Guidelines

To display configured buffer sizes, use this command line:

switch(config)# show running-config | include “ip routing”
 

This command does not require a license.

Examples

This example shows how to configure the size of the MRIB MFDM event history buffer:

switch(config)# ip routing multicast event-history mfdm size large
switch(config)#

 
Related Commands

Command
Description

Clears information in the IPv4 MRIB event history buffers.

Displays information in the IPv4 MRIB event history buffers.

Displays information about the running-system configuration.

ip routing multicast holddown

form of this command.

 
Syntax Description

ipv4

(Optional)

Initial route holddown period in seconds. The range is from 90 to 210. Specify 0 to disable the holddown period. The default is 210.

 
Defaults

The holddown period is 210 seconds.

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.2(1)

This command was introduced.

 
Usage Guidelines

To display the holddown period configuration, use this command line:

switch(config)# show running-config | include “ip routing multicast holddown”
 

This command does not require a license.

Examples

This example shows how to configure the routing holddown period:

switch(config)# ip routing multicast holddown 100
switch(config)#

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ip routing multicast software-replicate

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

No software replication.

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.2(3)

This command was introduced.

 
Usage Guidelines

By default, these packets are used by the software only for (S,G) state creation and then dropped.

 

This command does not require a license.

Examples

This example shows how to enable software replication of IPv4 PIM ASM packets:

switch(config)# ip routing multicast software-replicate
switch(config)#

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ipv6 mld access-group

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

Specifies the route-map policy name.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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 route-map 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 route-map policy:

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

 
Related Commands

Command
Description

Displays information about ICMPv6 interfaces.

ipv6 mld group-timeout

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld immediate-leave

form of this command.

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

 
Defaults

The immediate leave feature is disabled.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.1(3)

This command was introduced.

 
Usage Guidelines

command only when there is one receiver behind the interface for a given group.

This command does not require a license.

Examples

This example shows how to enable the immediate leave feature:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld immediate-leave
 

This example shows how to disable the immediate leave feature:

switch(config)# interface ethernet 2/2
switch(config-if)# no ipv6 mld immediate-leave
 

 
Related Commands

Command
Description

Displays IGMP information about the interface.

ipv6 mld join-group

form of this command.

}

}

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

Multicast group IPv6 address.

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

Specifies the route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(1)

.

 
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.

command.


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

Displays information about ICMPv6 interfaces.

ipv6 mld last-member-query-count

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld last-member-query-response-time

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld querier-timeout

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

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

Configures a querier timeout.

Displays information about ICMPv6 interfaces.

ipv6 mld query-interval

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld query-max-response-time

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld query-timeout

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

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

Configures a querier timeout.

Displays information about ICMPv6 interfaces.

ipv6 mld report-link-local-groups

form of this command.

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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

Displays information about ICMPv6 interfaces.

ipv6 mld report-policy

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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

Displays information about ICMPv6 interfaces.

ipv6 mld robustness-variable

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld ssm-translate

form of this command.

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

command.

IPv6 multicast source address.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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

Displays information about the running-system configuration.

ipv6 mld startup-query-count

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

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

Displays information about ICMPv6 interfaces.

ipv6 mld startup-query-interval

form of this command.

]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

 
Defaults

The startup query interval is 31 seconds.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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 startup query interval:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld 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 ipv6 mld startup-query-interval
switch(config-if)#

 
Related Commands

Command
Description

Displays information about ICMPv6 interfaces.

ipv6 mld state-limit

form of this command.

]

]]

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

(Optional) Specifies to use the route-map 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

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 state limit:

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld 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 ipv6 mld state-limit
switch(config-if)#

 
Related Commands

Command
Description

Displays information about ICMPv6 interfaces.

ipv6 mld static-oif

form of this command.

}

}

 
Syntax Description

(Optional) Specifies the Internet Control Message Protocol (ICMP) designator.

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

(Optional) Configures the source IPv6 address for MLDv2 and creates the (S, G) state.

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

Specifies the route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(1)

.

 
Usage Guidelines

command.

This command requires the Enterprise Services license.

Examples

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

switch(config)# interface ethernet 2/2
switch(config-if)# ipv6 mld static-oif FFFE::1
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 ipv6 mld static oif FFFE::1
switch(config-if)#

 
Related Commands

Command
Description

Displays information about the MLD local group membership.

ipv6 mld version

form of this command.

]

 
Syntax Description

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

 
Defaults

The version number is 2.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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 MLD version:

switch(config)# ipv6 mld version 1
 

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

switch(config)# no ipv6 mld version
 

 
Related Commands

Command
Description

Displays information about ICMPv6 interfaces.

ipv6 pim anycast-rp

form of this command.

 
Syntax Description

Address for the Anycast-RP address.

Address of the RP in the Anycast-RP set.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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)# ipv6 pim anycast-rp 2001:0db8:0:abcd::3 2001:0db8:0:abcd::31
 

This example shows how to remove a peer:

switch(config)# no ipv6 pim anycast-rp 2001:0db8:0:abcd::3 2001:0db8:0:abcd::31
 

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 pim bidir-rp-limit

form of this command.

 
Syntax Description

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

 
Defaults

The Bidir RP limit is 2.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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)# ipv6 pim bidir-rp-limit 6
 

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

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

 
Related Commands

Command
Description

Configures the number of Bidir RPs for PIM.

Displays information about the running-system configuration.

ipv6 pim border

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The interface is not on a PIM6 border.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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 PIM6 border:

switch(config)# ipv6 pim border
 

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

switch(config)# no ipv6 pim border
 

 
Related Commands

Command
Description

Displays information about PIM6-enabled interfaces.

ipv6 pim bsr bsr-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy.

This command requires the Enterprise Services license.

Examples

This example shows how to enable filtering of BSR messages:

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

This example shows how to disable filtering:

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

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 pim bsr-candidate

form of this command.

]

]

 
Syntax Description

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

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

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

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

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

 
Defaults

The priority is 64.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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 router as a BSR candidate:

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

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

switch(config)# no ipv6 pim bsr-candidate
 

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 pim bsr forward

form of this command.

]

]]

 
Syntax Description

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

Specifies to forward Bootstrap and Candidate-RP messages.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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.

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)# ipv6 pim bsr listen forward
 

This example shows how to disable listening and forwarding:

switch(config)# no ipv6 pim bsr listen forward
 

 
Related Commands

Command
Description

Enables listening to and forwarding of BSR messages.

Displays information about PIM6 RPs.

ipv6 pim bsr listen

form of this command.

]

]]

 
Syntax Description

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

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

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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.

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)# ipv6 pim bsr listen forward
 

This example shows how to disable listening and forwarding:

switch(config)# no ipv6 pim bsr listen forward
 

 
Related Commands

Command
Description

Enables listening to and forwarding of BSR messages.

Displays information about PIM6 RPs.

ipv6 pim bsr rp-candidate-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy.

This command requires the Enterprise Services license.

Examples

This example shows how to filter Candidate-RP messages:

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

This example shows how to disable message filtering:

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

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 pim dr-priority

form of this command.

]

 
Syntax Description

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

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 DR priority on an interface:

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

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

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

 
Related Commands

Command
Description

Displays information about PIM6-enabled interfaces.

ipv6 pim event-history

form of this command.

 
Syntax Description

Configures the assert receive event history buffer.

Configures the Bidr event history buffer.

Configures the CLI event history buffer.

Configures the hello event history buffer.

Configures the join-prune event history buffer.

Configures the null register event history buffer.

Configures the packet event history buffer.

Configures the PIM internal event history buffer.

Configures the rendezvous point (RP) event history buffer.

Configures the virtual routing and forwarding (VRF) event history buffer.

Specifies the size of the buffer to allocate.

.

 
Defaults

All history buffers are allocated as small.

 
Command Modes

Any command mode

 
Supported User Roles

vdc-operator

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the size of the PIM6 hello event history buffer:

switch(config)# ipv6 pim event-history hello size medium
switch(config)#

 
Related Commands

Command
Description

Clears information in the IPv6 PIM event history buffers.

Displays information in the IPv6 PIM event history buffers.

Displays information about the running-system PIM6 configuration.

ipv6 pim flush-routes

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

The routes are not flushed.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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)# ipv6 pim flush-routes
 

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

switch(config)# no ipv6 pim flush-routes
 

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ipv6 pim hello-interval

form of this command.

]

 
Syntax Description

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

 
Defaults

The PIM6 hello interval is 30,000 milliseconds.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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 PIM6 hello-message interval on an interface:

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

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

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

 
Related Commands

Command
Description

Displays information about PIM6-enabled interfaces.

ipv6 pim jp-policy

form of this command.

]

]

 
Syntax Description

Route-map policy name.

Specifies that the system applies a filter only for incoming messages.

Specifies that the system applies a filter only for outgoing messages.

 
Defaults

Disabled; no filter is applied for either incoming or outgoing messages.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(3)

parameters were added.

 
Usage Guidelines

keyword. When you enter the command with no arguments, that is no explicit direction, the system rejects further configurations if given with explicit direction.

command.

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)# ipv6 pim jp-policy my_jp_policy
 

This example shows how to disable filtering:

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

 
Related Commands

Command
Description

Displays information about PIM6-enabled interfaces.

ipv6 pim log-neighbor-changes

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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 PIM6 neighbor state changes:

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

This example shows how to disable logging:

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

 
Related Commands

Command
Description

Configures logging level of PIM6 messages.

ipv6 pim neighbor-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Forms adjacency with all neighbors.

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy to specify which groups to become adjacent to.

This command requires the Enterprise Services license.

Examples

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

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

This example shows how to reset to the default:

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

 
Related Commands

Command
Description

Displays information about PIM6-enabled interfaces.

ipv6 pim register-policy

form of this command.

]

 
Syntax Description

Route-map policy name.

 
Defaults

Disabled

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

 
Usage Guidelines

command in a route-map policy to specify the group or group and source addresses whose register messages that should be filtered.

To display the configured register policy, use this command line:

switch(config)# show running-config | include register-policy
 

This command requires the Enterprise Services license.

Examples

This example shows how to filter PIM6 Register messages:

switch(config)# ipv6 pim register-policy my_register_policy
 

This example shows how to disable message filtering:

switch(config)# no ipv6 pim register-policy
 

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ipv6 pim register-rate-limit

form of this command.

]

 
Syntax Description

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

 
Defaults

None

 
Command Modes

Global configuration (config)

 
Supported User Roles

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 PIM6 data registers:

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

This example shows how to remove a rate limit:

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

 
Related Commands

Command
Description

Displays information about PIM6 interfaces.

ipv6 pim rp-address

form of this command.

]

]

 
Syntax Description

IPv6 address of the router, which is the RP for the group range.

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

Specifies the route-map policy name.

(Optional) Specifies to handle group ranges in PIM6 bidirectional (Bidir) mode.

 
Defaults

The group range is treated in ASM mode.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.2(1)

.

 
Usage Guidelines

command.

This command requires the Enterprise Services license.

Examples

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

switch(config)# ipv6 pim rp-address 2001:0db8:0:abcd::1 group-list ff1e:abcd:def1::0/96
 

This example shows how to remove a static RP address:

switch(config)# no ipv6 pim rp-address 2001:0db8:0:abcd::1
 

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 pim rp-candidate

form of this command.

]

]

 
Syntax Description

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

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

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

Specifies a group range handled by the RP.

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

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

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

 
Defaults

The BSR message interval is 60 seconds.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

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 PIM6 BSR RP candidate:

switch(config)# ipv6 pim rp-candidate e 2/11 group-list ff1e:abcd:def1::0/24
 

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

switch(config)# no ipv6 pim rp-candidate
 

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 pim sparse-mode

form of this command.

]

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

Disabled

 
Command Modes

Interface configuration (config-if)

 
Supported User Roles

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 PIM6 sparse mode on an interface:

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

This example shows how to disable PIM6 on an interface:

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

 
Related Commands

Command
Description

Displays information about PIM6-enabled interfaces.

ipv6 pim ssm range

keyword.

}

}

 
Syntax Description

List of up to four group range prefixes.

Removes all group ranges.

Specifies the route-map policy name.

 
Defaults

The SSM range is FF3x/96.

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.1(2)

was added.

4.2(1)

.

 
Usage Guidelines

command.

This command requires the Enterprise Services license.

Examples

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

switch(config)# ipv6 pim ssm range FF30::0/32
 

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

switch(config)# no ipv6 pim ssm range none
 

This example shows how to remove all group ranges:

switch(config)# ipv6 pim ssm range none

 
Related Commands

Command
Description

Displays information about PIM6 group ranges.

ipv6 pim state-limit

form of this command.

]

]]

 
Syntax Description

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

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

(Optional) Route-map policy name.

(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

VRF configuration (config-vrf)

 
Supported User Roles

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:

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)# ipv6 pim state-limit 100000 reserved my_reserved_policy 40000
 

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

switch(config)# no ipv6 pim state-limit
 

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ipv6 pim use-shared-tree-only

form of this command.

]

 
Syntax Description

Route-map policy name that defines the group prefixes where this feature is applied.

 
Defaults

None

 
Command Modes

VRF configuration (config-vrf)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.0(1)

This command was introduced.

4.1(2)

was added and a route-map policy name is used to define groups.

 
Usage Guidelines

command in a route-map policy to specify the groups where shared trees should be enforced.

This command requires the Enterprise Services license.

Examples

This example shows how to create the PIM6 (*, G) state only for the group prefixes defined in my_group_policy:

switch(config)# ipv6 pim use-shared-tree-only group-list my_group_policy
 

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

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

 
Related Commands

Command
Description

Displays information about PIM6 RPs.

ipv6 routing multicast event-history

form of this command.

 
Syntax Description

Configures the CLI event history buffer.

Configures the multicast FIB distribution (MFDM) event history buffer.

Configures the multicast FIB distribution (MFDM) non-periodic events event history buffer.

Configures the MFDM sum event history buffer.

Configures the RIB event history buffer.

Configures the virtual routing and forwarding (VRF) event history buffer.

Specifies the size of the buffer to allocate.

.

 
Defaults

All history buffers are allocated as small.

 
Command Modes

Any command mode

 
Supported User Roles

vdc-operator

 
Command History

Release
Modification

4.1(2)

This command was introduced.

4.2(1)

.

 
Usage Guidelines

To display configured buffer sizes, use this command line:

switch(config)# show running-config | include “ipv6 routing”
 

This command does not require a license.

Examples

This example shows how to configure the size of the M6RIB MFDM event history buffer:

switch(config)# ipv6 routing multicast event-history mfdm size large
switch(config)#

 
Related Commands

Command
Description

Clears information in the IPv6 M6RIB event history buffers.

Displays information in the IPv6 M6RIB event history buffers.

Displays information about the running-system configuration.

ipv6 routing multicast holddown

form of this command.

 
Syntax Description

Initial route holddown period in seconds. The range is from 90 to 210. Specify 0 to disable the holddown period. The default is 210.

 
Defaults

The holddown period is 210 seconds.

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.2(1)

This command was introduced.

 
Usage Guidelines

To display the holddown period configuration, use this command line:

switch(config)# show running-config | include “ipv6 routing multicast holddown”
 

This command does not require a license.

Examples

This example shows how to configure the routing holddown period:

switch(config)# ipv6 routing multicast holddown 100
switch(config)#

 
Related Commands

Command
Description

Displays information about the running-system configuration.

ipv6 routing multicast software-replicate

form of this command.

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

No software replication.

 
Command Modes

Global configuration (config)

 
Supported User Roles

vdc-admin

 
Command History

Release
Modification

4.2(3)

This command was introduced.

 
Usage Guidelines

By default, these packets are used by the software only for (S,G) state creation and then dropped.

 

This command does not require a license.

Examples

This example shows how to enable software replication of IPv6 PIM ASM packets:

switch(config)# ipv6 routing multicast software-replicate
switch(config)#

 
Related Commands

Command
Description

Displays information about the running-system configuration.