ipv6 icmp error-interval

Configures ICMP rate limiting, that is, the rate at which IPv6 ICMP error messages are sent out on a network.
Syntax
ipv6 icmp error-interval interval [ size ]
no ipv6 icmp error-interval interval [ size ]
Command Default

ICMP rate limiting is enabled by default.

Parameters
interval
Specifies the interval in milliseconds at which tokens are placed in the bucket. Valid values are 0 through 2147483647 and the default value is 100 milliseconds. Setting the value to 0 disables ICMP rate limiting.
size
Specifies the maximum number of tokens stored in the bucket. Valid values are1 to 200 and the default is 10 tokens.
Modes

Global configuration mode

Usage Guidelines

You can limit the rate at which IPv6 ICMP error messages are sent out on a network. IPv6 ICMP implements a token bucket algorithm.

To illustrate how this algorithm works, imagine a virtual bucket that contains a number of tokens. Each token represents the ability to send one ICMP error message. Tokens are placed in the bucket at a specified interval until the maximum number of tokens allowed in the bucket is reached. For each error message that ICMP sends, a token is removed from the bucket. If ICMP generates a series of error messages, messages can be sent until the bucket is empty. If the bucket is empty of tokens, error messages cannot be sent until a new token is placed in the bucket.

If you configure the interval value to a number that does not evenly divide into 100000 (100 milliseconds), the system rounds up the value to a next higher value that does divide evenly into 100000. For example, if you specify an interval value of 150, the system rounds up the value to 200.

The no form of the command disables ICMP rate limiting.

Examples

The following example configures the interval to 1000 milliseconds and the number of tokens to 100 tokens.

device(config)# ipv6 icmp error-interval 1000 100