PD_RANGE#

code: 145

# set
<module-index>/<port-index> PD_RANGE [<dataset_index>] <start> <step> <bucket_count>

# get
<module-index>/<port-index> PD_RANGE [<dataset_index>] ?

Description#

The bucket ranges used for classifying the packets counted by a histogram of a port. The packets are either counted by length, measured in bytes, by inter- frame gap to the preceding packet, also measured in bytes, or by latency in transmission measured in nanoseconds. There are a fixed number of buckets, each middle bucket covering a fixed-size range of values which is a power of two. The first and last buckets count all the packets that do not fit within the ranges of the middle buckets. The buckets are placed at a certain offset by specifying the first value that should be counted by the first middle bucket.

Actions#

set, get

Parameters#

  1. start: integer, first value going into the second bucket

  2. step: integer, the span of each middle bucket: (1) 1,2,4,8,16,32,64,128,256,512 (bytes, non-latency histograms). (2) 16,32,64,128,…,1048576,2097152 (nanoseconds, latency histograms)

  3. bucket_count: integer, the total number of buckets

Example#

# set
input:  0/1 PD_RANGE [0] 1 1 1
output: <OK>

# get
input:  0/1 PD_RANGE [0] ?
output: 0/1 PD_RANGE [0] 1 1 1