no ip igmp access-group access-list-number [version]
access-list-number
The IP standard access-list number (1 99).
version
Optional. This changes the IGMP version number. The default is 2.
IOS Version
10.2
Example
Configure the ethernet 0 interface on a router so that hosts can only join multicast groups 239.0.0.0 through 239.255.255.255.
interface ethernet 0
ip igmp access-group 1
access-list 1 permit 239.0.0.0 0.255.255.255
ip igmp helper-addressip-address
no ip igmp helper-addressip-address
ip-address
The IP address where IGMP Host Reports and Leave messages are forwarded.
IOS Version
11.3
ip igmp join-group group-address
no ip igmp join-group group-address
group-address
The Multicast group IP address. Packets are process-switched.
IOS Version
10.2
Example
Configure interface ethernet 0 to join the multicast group 225.250.250.1.
interface ethernet 0
ip igmp join-group 225.250.250.1
ip igmp query-intervalseconds
no ip igmp query-intervalseconds
seconds
The number of seconds between host-query messages. Its value can be between 0 and 65535.
IOS Version
10.2
Example
Change the query interface on interface serial 0 to three minutes.
interface serial 0
ip igmp query-interval 180
ip igmp query-max-response-timeseconds
no ip igmp query-max-response-timeseconds
seconds
The maximum response time that is advertised in IGMP queries.
IOS Version
11.1
Example
Configure the maximum response time on interface ethernet 0 to 15 seconds.
interface ethernet 0
ip igmp query-max-response-time 15
ip igmp query-timeoutseconds
no ip igmp query-timeoutseconds
seconds
The number of seconds a non-querier router will wait before taking over as querier if the current querier times out.
IOS Version
11.1
Example
Change the query timeout value to 60 seconds on interface serial 1.
interface serial
ip igmp query-interval 30
ip igmp query-timeout 60
ip igmp static-group group-address
no ip igmp static-group group-address
group-address
The group IP multicast address. Packets are fast-switched.
IOS Version
11.2
Example
Configure interface ethernet 0 to join the multicast group 225.250.250.1.
interface ethernet 0
ip igmp static-group 225.250.250.1
ip igmp version {2| 1 }
no ip igmp version {2 | 1 }
IOS Version
11.1
Example
Configure the ethernet 0 interface to use IGMP version 1. If version 1 is configured on an interface, then the commands ip igmp query-max-response-time and ip igmp query-timeout cannot be used because they are version 2-specific.
interface ethernet 0
ip igmp version 1
Cisco Group Management Protocol Commands
Router Commands
Command
Description
ip cgmp
Enables CGMP on an interface or subinterface
ip cgmp proxy
Enables CGMP and DVMRP proxy on an interface or subinterface
clear ip cgmp [interface]
Clears all CGMP groups
show ip igmp interface [interface]
Shows if CGMP is enabled on an interface
debug ip cgmp
Debugs CGMP traffic
Switch Commands
Command
Description
set cgmp enable
Enables CGMP on the switch
set cgmp disable
Disables CGMP on the switch
show multicast router
Lists the ports on the switch that are router ports
This command configures the default administrative distance for received DVMRP routes. It should be used so that routes advertised from the unicast routing table that are reflected back through DVMRP cause the original unicast routes to continue to be advertised. The ip dvmrp accept-filter command can override this value when specified on an interface.
ip dvmrp route-hog-notificationcount
no ip dvmrp route-hog-notification count
count
Number of routes allowed before a syslog message is sent. The default is 10,000 routes.
IOS Version
10.2
This global command places a limit on the number of routes that can be advertised over a DVMRP-enabled interface, including tunnels, during a one-minute interval.
ip dvmrp route-limitcount
no ip dvmrp route-limitcount
count
The number of DVMRP routes that can be advertised. The default value is 7000.
IOS Version
11.0
Interface Configuration Commands
ip dvmrp accept-filter access-list-number[distance] neighbor-list access-list-number
no ip dvmrp accept-filter access-list-number [distance] neighbor-list access-list-number
access-list-number
The IP standard access list number (0 99). If 0, then all sources are accepted with the value of distance.
distance
Optional. The administrative distance of the reported route.
neighbor-list
Reports are only accepted from neighbors in the list.
access-list-number
IOS Version
10.2
ip dvmrp auto-summary
IOS Version
11.2
This interface command is enabled by default. Auto-summarization is when subnets are advertised as a classful network number. To turn off this feature, use the no form of the command.
ip dvmrp default-information {originate | only}
no ip dvmrp default-information {originate | only}
originate
Routes more specific than the default route (0.0.0.0) can be advertised.
only
Only the default route (0.0.0.0) is advertised.
IOS Version
10.2
This interface command is used to advertise the default network 0.0.0.0. to the DVMRP neighbor on the interface. The originate option allows more specific routes to be advertised. The only keyword prevents other routes from being advertised. Do not use this command to create a default route to the MBONE.
ip dvmrp metric metric [listaccess-list] {[protocol process-id] | dvmrp]
ip dvmrp metric metric route-mapmap-name
no ip dvmrp metricmetric [listaccess-list] {[protocol process-id] | dvmrp]
no ip dvmrp metricmetricroute-mapmap-name
metric
The metric to be used for the routes in the DVMRP route report. Its value can be between 0 and 32. A value of 0 prevents a route or routes from being advertised. A value of 32 indicates infinity or an unreachable value.
list access-list
Optional. A standard IP access list can be used to control which routes are reported.
protocol
Optional. The unicast routing protocol name (rip, igrp, eigrp, ospf, bgp, isis, static, or dvmrp).
process-id
Optional. The unicast routing protocol process ID.
dvmrp
Optional. This allows routes in the DVMRP routing table to be filtered or have their metric adjusted..
route-map map-name
This filters the unicast routes that are reported using a route map..
IOS Version:
10.2. Route Map added in 11.1.
ip dvmrp metric-offset [in | out]increment
no ip dvmrp metric-offset [in | out]increment
in
Optional. The value of increment is added to routes in incoming DVMRP route reports. The default increment for in is 1.
out
Optional. The value of the increment is added to routes in outgoing DVMRP reports. The default increment for out is 0.
increment
Value added to the routes in a DVMRP route report.
IOS Version
11.0
Use this interface command to adjust the metric of DVMRP routes being received on an interface (in) or reported to a neighbor (out). The default value when applied to incoming routes is 1 and the default value applied to outgoing routes is 0. Be careful, this command adds the same metric to all incoming or outgoing routes.
ip dvmrp output-report-delaydelay-time [burst]
no ip dvmrp output-report-delaydelay-time [burst]
delay-time
The number of milliseconds between DVMRP route reports.
burst
Optional. The number of packets in a set of route reports. The default value is 2.
IOS Version
11.2
Use this interface command to pace the route reports to a neighbor.
ip dvmrp reject-non-pruners
no ip dvmrp reject-non-pruners
IOS Version
11.0
This interface command prevents peering with a DVMRP neighbor that does not support pruning and grafting.
ip dvmrp summary-addressaddress mask [metricvalue]
no ip dvmrp summary-addressaddress mask [metricvalue]
address
The summary IP address that is advertised.
mask
The mask for the summary address.
metric value
Optional. The metric that is advertised for the summary address. The default metric is 1.
IOS Version
11.2
Used on an interface to summarize addresses in a route report.
tunnel mode dvmrp
no tunnel mode dvmrp
IOS Version
10.2
This configures a Cisco tunnel to encapsulate IP using protocol number 4. This mode can be used when a Cisco connects to a mrouted machine to run DVMRP over a tunnel. This is a popular way to connect to the MBONE. It is required to configure PIM and an IP address on a DVMRP tunnel. This mode is not used to construct a tunnel between a pair of Cisco routers.
ip dvmrp unicast-routing.
no ip dvmrp unicast-routing.
IOS Version
10.3
Enables the exchange of DVMRP routes between routers.
Protocol Independent Multicast Commands
Global Configuration Commands
ip pim accept-rp {address | auto-rp} [access-list-number]
no ip pim accept-rp {address | auto-rp} [access-list-number]
address
The address of the RP.
auto-rp
Messages are accepted only for RPs that are in the Auto-RP cache.
access-list-number
Optional. Defines the groups that are allowed.
IOS Version
11.1
This command causes the router to accept only Join and Prune messages destined for the specified RP. If an access-list is used, then the group must also be allowed by the list.
ip pim bsr-candidate interface-type interface-number hash-mask-length [priority]
no ip pim bsr-candidate interface-type interface-number hash-mask-length [priority]
interface-type interface-number:
The address of the specified interface identifies the BSR.
hash-mask-length
The length of the mask (32 bits maximum) that is ANDed with the group address before the hash function is called. All groups with the same seed correspond to the same RP. If the value is 24, then only the first 24 bits of the group address are used. Therefore, one RP can have multiple groups.
priority
Optional. Its value can be from 0 to 255. The BSR candidate with the largest priority is preferred. If BSR candidates have the same priority, the one with the highest IP address is elected as the BSR.
IOS Version
11.3T
This command causes the router to send Bootstrap messages to PIM neighbors.
ip pim register-rate-limit pps
no ip pim register-rate-limit pps
pps
The packet per second rate limit.
IOS Version
11.3T
Sets a limit on the maximum number of data registers per second sent for each (S,G).
ip pim rp-addressip-address [access-list-number] [override]
no ip pim rp-addressip-address [access-list-number] [override]
ip-address
The IP address of the RP.
access-list-number
Optional. The standard IP access list number from 1 100. If no access list is used, then the RP can handle all groups. Use an access list to limit the groups that the RP will service.
override
Optional. If there is a conflict between the static RP and one configured using Auto-RP, then the static RP takes precedence.
IOS Version
10.2 override keyword 11.2
ip pim rp-announce-filter rp-list access-list-numbergroup-listaccess-list number
no ip pim rp-announce-filter rp-list access-list-numbergroup-listaccess-list number
rp-list access-list-number
The standard access list of RP addresses from which Auto-RP announcements are accepted.
group-list access-list-number
The standard access list of group addresses that are accepted.
IOS Version
11.1
For example, to configure an RP mapping agent to accept Auto-RP announcements from the RP with address 172.16.1.1 for all multicast groups, use
ip pim rp-announce-filter rplist 12 group-list 13
access-list 12 permit 172.16.1.1
access-list 13 permit 224.0.0.0 15.255.255.255
ip pim rp-candidate interface-type interface-number[group-listaccess-list-number]
no ip pim rp-candidate interface-type interface-number [group-listaccess-list-number]
interface-type interface-number
The address of the specified interface identifies the candidate RP.
group-list access-list-number
Optional. The standard IP access list that determines the groups that the candidate RP advertises.
IOS Version
11.3T
To configure a candidate RP that will advertise any multicast group starting with 227, the following command can be used.
ip pim rp-candidate serial 1 group-list 51
access-list 51 permit 227.0.0.0 0.255.255.255
ip pim send-rp-announce interface-type interface-numberscopettl
group-listaccess-list-number
no ip pim send-rp-announceinterface-type interface-numberscopettl
group-listaccess-list-number
interface-type interface-number
The address of the specified interface identifies the RP.
scope
The TTL value of the announcements that limits the distance an RP announcement can travel.
access-list-number
An access list determines the groups that the RP is announcing it can service.
IOS Version
11.1
The router sends RP announcements on all PIM-enabled interfaces for a maximum number of hops specified by the scope parameter. The announcements are sent to the group CISCO-RP-ANNOUNCE (224.0.1.39).
ip pim send-rp-discovery scope ttl
no ip pim send-rp-discovery scope ttl
scope
The TTL of the discovery messages. Used to limit the scope of the message.
IOS Version
11.1
The router configured as a mapping agent listens for RP announcements to group CISCO-RP-ANNOUNCE (224.0.1.39). The RP mapping agent then sends the RP-to-group mappings to the group CISCO-RP-DISCOVERY (224.0.1.40) and PIM routers get their RP information from the discovery messages.
ip pim spt-threshold {kbps | infinity} [group-listaccess-list-number]
no ip pim spt-threshold {kbps | infinity} [group-listaccess-list-number]
kbps
The traffic rate in kilobits per second.
infinity
The specified groups will use the shared-tree.
group-list access-list-number
Optional. This determines which groups to apply the threshold to.
IOS Version
11.1
Interface Configuration Commands
ip pim border
no ip pim border
IOS Version
11.3T
This command is used to configure a bootstrap border router.
ip pim dense-mode
ip pim sparse-mode
ip pim sparse-dense-mode
no ip pim dense-mode
no ip pim sparse-mode
no ip pim sparse-dense-mode
IOS Version
Dense and Sparse mode, 10.2 Sparse-dense mode, 11.1
This command enables PIM on an interface.
ip pim minimum-vc-rate pps
no ip pim minimum-vc-rate pps
pps
This sets the minimum packets per second rate to the value given by pps.
IOS Version
11.3
This configures the activity level that determines whether VCs will be considered for deletion. If the number of VCs open already equals the maximum number allowed, then packets for new groups are sent over the static multicast VC.
ip pim multipoint-signaling
no ip pim multipoint-signaling
IOS Version
11.3
This enables the use of multipoint VCs per multicast group.
ip pim nbma-mode
no ip pim nbma-mode
Only receivers that have joined a particular multicast group receive packets for that group. Use this with PIM-Sparse mode and configure the hub router to be the RP.
ip pim neighbor-filter access-list
no ip pim neighbor-filter access-list
access-list
The standard IP access list number.
IOS Version
11.3
This filters PIM control messages based on the given access list. It does not filter Auto-RP announcements and is used with Sparse mode PIM on a non-broadcast multi-access network. Multicast packets will only be sent to neighbors that have joined the group.
ip pim query-interval seconds
no ip pim query-interval seconds
seconds
1 65535 seconds.
IOS Version
10.2
The following command changes the PIM query interval to 60 seconds.
interface Serial 0
ip pim query-interval 60
ip pim vc-count number
no ip pim vc-count number
number
The maximum number of VCs that PIM can open. The default value is 200.
IOS Version
11.3
ip pim version [1 | 2]
no ip pim version [1 | 2]
IOS Version
11.3T
This sets the PIM version number.
ip pim message-interval seconds
seconds
A value in the range from 1 to 65535.
By default, a PIM-SM router sends periodic Join/Prune messages every 60 seconds.
Show and Debug Commands
debug ip pim [group-name-or-address]
group-name-or-address
Optional. This is the group IP address or configured name.
IOS Version
10.2
This displays PIM packets received and transmitted as well as PIM-related events.
debug ip pim auto-rp
IOS Version
11.1
This displays Auto-RP packet activity.
debug ip pim atm
IOS Version
11.3
This displays PIM ATM signaling activity.
Multicast Support Commands
Global Commands
ip multicast-routing [distributed]
no ip multicast-routing
distributed
This enables distributed fast-switching,.
IOS Version
10.2. distributed, added in 11.2
This enables IP multicast forwarding. If disabled, multicast packets are discarded.
ip multicast cache-headers [rtp] [entries]
no ip multicast cache-headers [rtp] [entries]
rtp
RTP headers are cached.
entries
The number of cache entries. The number is interpreted as a power of two.
IOS Version
11.1
This allocates a circular buffer to store IP multicast packet headers received by the router. This command allocates a buffer of approximately 32-kilobytes.
ip mroutesource mask [protocol process-number] [route-mapmap]
rpf-address | interface [distance]
no ip mroutesource mask [protocol process-number] [route-mapmap]
rpf-address | interface [distance]
source mask
The IP address/mask of the multicast source.
protocol
Optional. The unicast routing mode (OSPF, EIGRP, etc.).
process-number
Optional. The process number of the routing protocol that is being used.
rpf-address
The incoming interface for the mroute. If the Reverse Path Forwarding address rpf-address is a PIM neighbor, PIM Joins, Grafts, and Prunes are sent.
interface
The interface type and number for the mroute (ethernet 0 , serial 1, etc.).
distance
Optional. This determines whether a unicast route, a DVMRP route, or a static mroute should be used for the RPF lookup. The lower distances have better preference. If the static mroute has the same distance as the other two RPF sources, the static mroute takes precedence. The default is 0.
IOS Version
11.0
This configures a multicast static route (static mroute).
ip sdr cache-timeout minutes
minutes
The amount of time an SDR cache entry stays active in the cache. A value of 0 indicates the entry never expires. The default value is 24 hours.
IOS Version
11.2
Interface Commands
ip multicast ttl-threshold ttl-value
ttl-value
TTL threshold value.
IOS Version
10.2
The TTL-threshold is applied to all outgoing multicast traffic. If the TTL value of a multicast packet is less than the threshold, the packets are not forwarded. The default value is 0, so all multicast packets are forwarded.
ip multicast rate-limit in | out [video] | [whiteboard] [group-listaccess-list]
[source-listaccess-list] [kbps]
in
Only packets at the rate of kbps or slower are accepted on the interface.
out
Only a maximum of kbps are transmitted on the interface.
video
Optional. Rate limiting is performed based on the UDP port number used by video traffic, which is identified by consulting the SDR cache.
whiteboard
Optional. Rate limiting is performed based on the UDP port number used by whiteboard traffic, which is identified by consulting the SDR cache.
group-list access-list
Optional. An access list that is used to determine which multicast groups will be constrained by the rate limit.
source-list access-list
Optional. An access list that is used to determine which senders will be constrained by the rate limit.
kbps
Rate limit in kilobits per second. Packets sent at a rate greater than kbps are discarded. If no value is given, then the default rate is 0 kilobits per second. In this case, no multicast traffic is permitted.
IOS Version
11.0
This command requires that ip sdr listen be enabled so port numbers can be obtained from the SDR cache. If SDR is not enabled, then no limiting occurs.
ip multicast boundary access-list-number
no ip multicast boundary access-list-number
access-list-number
The standard IP access-list (1 99).
IOS Version
11.1
Use the following form of the command on the router attached to the sender or first hop route.
ip multicast helper-map broadcast multicast-address extended-acl
no ip multicast helper-map broadcast multicast-address extended-acl
broadcast
This specifies the traffic is being converted from broadcast to multicast.
multicast-address
The multicast group address of the traffic that is to be converted to broadcast traffic.
Use the following form of the command on the router attached to the receiver or last hop router.
ip multicast helper-map group-address IP-broadcast-address extended-acl
no ip multicast helper-mapgroup-address IP-broadcast-address extended-acl
group-address
The multicast group address of traffic to be converted to broadcast traffic.
IP-broadcast-address
The IP broadcast address to which broadcast traffic is sent.
extended-acl
The IP-extended access list that determines which broadcast packets are to be converted to multicast. Based on the UDP port number.
access-list-number
The IP extended access list that controls which broadcast packets are translated, based on the UDP port number.
IOS Version
11.1
This enables broadcast-to-multicast conversion on the first hop router and multicast-to-broadcast conversion on the last hop router
ip mroute-cache [distributed]
no ip mroute-cache [distributed]
distributed
This enables distributed fast-switching on the interface.
IOS Version
11.0
Multicast packets can either be process-switched or fast-switched on an interface and this command configures IP multicast fast-switching. The default setting is when all interfaces are multicast fast-switched.
ip sdr listen
no ip sdr listen
IOS Version: 11.1
This command enables the router to accept SDAP packets on the interface and the router joins the multicast group 224.2.127.254. SDR entries are cached on the router and the time that an SDR remains in the cache is configured using the global configuration command.
ip multicast use-functional
no ip multicast use-functional
IOS Version
11.1
This enables the use of the MAC address 0xc000.0004.0000 for the transmission and reception of IP Multicast traffic on token ring interfaces.
Clear commands
clear ip mroute [group-name | group-address [source-address]] | [*]
IOS Version
10.2.
This deletes entries from the IP multicast routing table
clear ip igmp group [group-name | group-address|interface-type interface-number]
group-name
Optional. The multicast group name defined either in DNS or by the ip host command.
group-address
Optional. The multicast group address.
interface-type interface-number
This specifies the interface (Ethernet 0, serial 0, and so on)
IOS Version
10.2
Examples
To clear a particular group, clear ip igmp group 225.250.250.1.
To clear all groups on an interface, clear ip igmp group ethernet 0.
To clear all groups, clear ip igmp group.
clear ip cgmp [interface]
IOS Version
11.1
This sends a CGMP Leave message with a group address of 0000.0000.0000 and a unicast address of 0000.0000.0000. This instructs the switches to clear all group entries they have cached. If interface is specified, the Leave is sent only on interface. Otherwise, it is sent on all CGMP-enabled interfaces.
clear ip dvmrp route * | route
*
Deletes all DVMRP routes
route
Deletes a specific DVMRP route.
IOS Version
10.2
Deletes routes from the DVMRP routing table
clear ip sdr [group-address | session-name]
group-address
The address of the group to clear.
session-name
The name of the session to clear.
IOS Version
11.1
Clears an SDR cache entry. If no parameters are given, then the entire SDR cache is cleared.
clear ip pim interface [interface] count
Clears the multicast packet counters for interface [interface] or clears for all interfaces when [interface] is not specified ([11.2]).
clear ip pim auto-rp <rp-address>
rp-address
Optional. The address of the RP to clear.
IOS Version
11.2
Clears the Auto-RP cache.
Show Commands
show ip pim neighbor [interface]
interface
Optional. Interface name and number.
IOS Version
10.2
Displays PIM neighbors.
show ip pim vc [group-or-name] [interface]
group-or-name
Optional. The IP address of the multicast group or configured name.
interface
Optional. The interface name and number.
IOS Version
11.3
Displays ATM VC status information for multipoint VCs opened by PIM.
show ip pim bsr
IOS Version
11.3T
Displays Bootstrap router (BSR) information.
show ip pim rp-hash <group>
IOS Version
11.3T
Displays which RP is being selected for the ,group..
show ip pim interface [interface-type interface-number] [count]
interface-type interface-number
Optional. The type and number of the interface (Ethernet 0, Serial 1, and so on).
count
Optional. The number of packets that have been sent and received on the interface.
IOS Version
10.2
show ip pim rp [group-name | group-address | mapping]
group-name
Optional. Shows RPs for the named group.
group-address
Optional. Shows RPs for the group with the entered group address.
mapping
Optional. Displays all group to RP mappings.
IOS Version
10.2
show ip mroute [[group-name | group-address] [source-address]] [summary]
This displays the IP multicast routing table. When summary is specified, a one-line abbreviated display is provided. When count is specified, group count, source count, and packet count statistics are provided ([10.2]).
show ip mroute [[group-name | group-address] [source-address]] count
This displays the packet count per the (S,G) multicast routing table entry. It also includes the average packet size and data rate in kilobits per second ([10.2]).
show ip mroute [<group-name | group-address] active [kbps]
This command shows you the rate that active sources send to multicast groups. You can display for all groups or specify a single group. [kbps] only displays sources that are sending greater than or equal to itself. The default setting shows all sources sending at a rate greater than or equal to one kilobit per second. If SD is running on the router, the SD session name is displayed ([11.0]).
RSVP Commands
Interface Commands
ip rsvp bandwidth interface-kbps single-flow-kbps
no ip rsvp bandwidth interface-kbps single-flow-kbps
interface-kbps
Optional parameter. Its value can be from 1 10,000,000.
single-flow-kbps
Optional parameter. Its value can be 1 10,000,000.
The parameters shown in brackets are optional parameters. The first optional parameter is the total amount of bandwidth that will be reserved on the interface for RSVP flows. The second optional parameter is the amount of bandwidth that can be allocated to a single flow. By default, 75 percent of the bandwidth on an interface can be reserved.
ip rsvp neighbors access-list-number
no ip rsvp neighbors access-list-number
access-list-number
Integer from 1 to 199. 1 to 99 for a standard access list. 100 to 199 for an extended access list.
By default, any neighbor can request a reservation on a router interface. If only selected neighbors are to be permitted to request a reservation using RSVP, we would use this interface command for PATH messages:
ip rsvp sendersession-ip-address sender-ip-address