ip mroute

To configure multicast reverse path forwarding (RPF) static routes, use the ip mroute command. To remove RPF static routes, use the no form of this command.

ip mroute { ip-addr ip-mask | ip-prefix } {{ next-hop | nh-prefix } | { ethernet slot / port | loopback if_number | port-channel number | vlan vlan-id }} [ pref ] [ vrf vrf-name ]

no ip mroute { ip-addr ip-mask | ip-prefix } {{ next-hop | nh-prefix } | { ethernet slot / port | loopback if_number | port-channel number | vlan vlan-id }} [ pref ] [ vrf vrf-name ]

Syntax Description

ip-addr
IP prefix in the format i.i.i.i.
ip-mask
IP network mask in the format m.m.m.m.
ip-prefix
IP prefix and network mask length in the format x.x.x.x/m.
next-hop
IP next-hop address in the format i.i.i.i.
nh-prefix
IP next-hop prefix in the format i.i.i.i/m.
ethernet slot / port
Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.
loopback if_number
Specifies the loopback interface. The loopback interface number is from 0 to 1023.
port-channel number
Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.
vlan vlan-id
Specifies the VLAN interface. The range is from 1 to 4094.
pref
(Optional) Route preference. The range is from 1 to 255. The default is 1.
vrf vrf-name
(Optional) Specifies the virtual routing and forwarding (VRF) context name. The name can be any case-sensitive, alphanumeric string up to 32 characters.

Command Default

The route preference is 1.

Command Modes

Global configuration mode

Command History

Release
Modification
5.0(3)N1(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.0.2.33/24 192.0.2.1
switch(config)#
 

This example shows how to remove an RPF static route:

switch(config)# no ip mroute 192.0.2.33/24 192.0.2.1
switch(config)#

Related Commands

Command
Description
show ip mroute
Displays information about multicast routes.