[c-nsp] ip multicast rate-limit

[Hank Nussbacher]

I am wondering what is up with the "ip multicast rate-limit" command.  A 
few gotcha's from Cisco:

a) doesn't work on 12.2(18)SXE4:

petach-tikva-gp(config-if)#ip multicast ?
   boundary       Boundary for administratively scoped multicast addresses
   helper-map     Broadcast to Multicast map OR Multicast to ip-address map
   netflow        NetFlow accounting for multicast
   rate-limit     Rate limit multicast data packets
   tagswitch      Enable IP Multicast Tagswitching
   ttl-threshold  TTL threshold for multicast packets

petach-tikva-gp(config-if)#ip multicast rate-limit ?
   in   Rate limit incoming packets
   out  Rate limit outgoing packets

petach-tikva-gp(config-if)#ip multicast rate-limit in 40000
  "ip multicast rate-limit" command is not supported

Was introduced in 11.0 so should be available and the CLI shows it as 
available.  No altrernate command suggested.  See below.

b) On:
<http://www.cisco.com/en/US/products/ps6350/products_command_reference_book09186a008042def5.html>
the left hand menu shows a link for "IP Multicast Commands: ip multicast 
rate-limit through ip urd", which is a mistake and should be 'route-limit' 
to 'urd'.

c) On:
<http://www.cisco.com/en/US/products/hw/routers/ps368/products_command_reference_chapter09186a0080172751.html>
it lists the command for 12.2SX as being "mls ip multicast rate-limit" yet 
the link to the actual page shows the command as being now "mls rate-limit 
multicast ipv4..."  Looks like someone has been playing fast and loose with 
the CLI syntax and changing their minds every few months :-)

d) Following the multicast trail, I see the mls command has an igmp option 
such as "mls rate-limit multicast ipv4 igmp" for rate limiting igmp pps, 
yet 12.2(18)SXE4  one can still do
petach-tikva-gp(config-if)#ip igmp limit ?
   <1-64000>  Max Allowed State on this interface
Couldn't Cisco put all multicast limiters in one spot in the CLI?  Can't 
Cisco indicate a command has been deprecated and what the new command 
should be?  Can't Cisco check their documentation?

Thanks,
Hank