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-groupgroup-address
no ip igmp join-groupgroup-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-groupgroup-address
no ip igmp static-groupgroup-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-candidateinterface-type interface-number
hash-mask-length
[priority]
no ip pim bsr-candidateinterface-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-listaccess-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-candidateinterface-type interface-number[group-listaccess-list-number]
no ip pim rp-candidateinterface-type interface-number [group-listaccess-list-number]
interface-type interface-number
The address of the specified interface identifies the
candidate RP.
group-listaccess-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-announceinterface-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 scopettl
no ip pim send-rp-discovery scopettl
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-listaccess-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-intervalseconds
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-listaccess-list
Optional. An access list that is used to determine which
multicast groups will be constrained by the rate limit.
source-listaccess-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 boundaryaccess-list-number
no ip multicast boundaryaccess-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-mapgroup-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-typeinterface-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-typeinterface-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 bandwidthinterface-kbps single-flow-kbps
no ip rsvp bandwidthinterface-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 neighborsaccess-list-number
no ip rsvp neighborsaccess-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