Buckets

The buckets group defines token buckets to be used for policing. It contains statements with the following syntax:

bucket new_bucket = rate mpu depth initial_tokens overflow_bucket pragmas

new_bucket

is the index of the new token bucket. This number must be greater than zero.

rate

is the bucket rate in bytes per second. Tokens are added to the bucket at this rate.

mpu

is the minimum policed unit, in bytes. Packets smaller than mpu are treated as if they were of size mpu.

depth

is the depth of the token bucket in bytes, i.e. the maximum number of tokens, or the ``credit'', the bucket can accumulate.

initial_tokens

is the initial number of tokens available in the bucket.

overflow_bucket

is the number of the bucket that receives excess tokens from the current bucket. overflow_bucket is 0 if excess tokens will be discarded.

pragmas

is an optional list of space-separated pragmas

rate and depth are unsigned 32-bit integers. Therefore, the maximum values are a rate of 34 Gbps, and a depth of 4 GB, or one second at the maximum rate.