ip mroute

Use this command to add or remove a static IP multicast route. This command is valid only when an ipv4 multicast topology is configured for this router.


ip mroute <prefix> {<prefix-mask>} | <prefix/prefix-length> vlan <vlan-id> {[<distance>] [tag <tag-id>]} reject {[<distance>] [tag <tag-id>]} blackhole {[<distance>] [tag <tag-id>]} interface <interface-name> {[<distance>] [tag <tag-id>]} <ip-address> {[interface <interface-name>] | [recursive] [<distance>] [tag <tag-id>] [probe {default | <probe-name>}] vrf <vrf-name> {[<distance>] [tag <tag-id>]}
no ip mroute <prefix> {<prefix-mask>} | <prefix/prefix-length>


prefix Specifies a destination IP address prefix.
prefix mask Specifies a destination prefix mask.
prefix/prefix-length Specifies a destination IP address in prefix/prefix-length format.
ip-address Specifies a next-hop router IP address.
interface interface-name Specifies the next-hop interface.
vlan vlan-id Specifies the next-hop VLAN. Valid values are 1 - 4094.
vrf vrf-name Specifies that the destination is in VRF router with this name.
blackhole Specifies that packets destined for this route‘s subnet are silently dropped. An ICMP network unreachable message is not sent to the packet source.
reject Specifies that packets destined for this route‘s subnet are dropped, and an ICMP network unreachable message is sent to the packet source.
recursive (Optional) Specifies that the next-hop interface is determined by route lookup.
distance (Optional) Specifies an administrative distance metric for this route. Valid values are 1 (default) to 255. Routes with lower values receive higher preference in route selection.
tag tag-id (Optional) Specifies an OSPF tag ID for this route. Valid values are 1 - 4294967295.
default Uses the default static route probe
probe-name Specifies the name of a probe to use.


  • If distance is not specified, the default value of 1 is applied.
  • If an OSPF tag ID is not specified, no OSPF tag is associated with the route.
  • If recursive is not specified, see usage section below.


Configuration command mode.


This command is used to configure static multicast routes. The route forwards IP traffic depending upon the IP forwarding setting of the routing interface. Routing interfaces are set for IP forwarding by default. To configure a static multicast route as a non-forwarding IP route, set IP forwarding for the routing interface to non-forwarding using the no ip forwarding command in interface configuration mode.

Use the vrf egress-vrf parameter to point to the egress VRF router that will perform the next-hop lookup for this static route. Using the vrf egress-vrf parameter is more dynamic than configuring a standard static route, in that it determines the next hop based upon a route table lookup. A standard static route specifies a single next hop. Should that next hop be unavailable, the subnet is no longer reachable. A standard static route can be configured to reach the next hop that is a member of a different VRF using the syntax: ip route destination-prefix/length next-hop-address interface next-hop-interface. Because the vrf egress-vrf parameter provides greater flexibility in determining the next hop, it is recommended that you use the vrf egress-vrf parameter.



The default VRF router is referred to as the global router. Named VRF routers within a device configured using the set router vrf create command are referred to as non-global VRF routers. Static routes are supported between both the global router and any non-global VRF router and between any two non-global VRF routers.

If you only enter the prefix/length and the IP address of the nexthop router and do not specify the optional recursive parameter, a search is performed of all configured subnets for a subnet containing the next?hop. If found, the static route is anchored to that interface, else it becomes a recursive route.

See ipv6 mroute for IPv6 static multicast route configuration command information.

The “no” form of this command removes the static IP multicast route.


This example shows how to set IP address as the next hop gateway to destination address

System(rw-router-config)->ip mroute

This example shows how to set VLAN 100 as the next hop interface to destination address

System(rw-router-config)->ip mproute vlan 100