lquantize() Function

The lquantize() action stores unsigned 64-bit values in buckets similar to the quantize() action. However, the number and range of buckets is specified in the arguments to the lquantize() action. The arguments to the lquantize() action are:

• Value of interest

• Lower bound of the linear quantization

• Upper bound of the linear quantization

• Step value between levels

The first 64 bits of the data encode the following values:

• DTRACE_LQUANTIZE_BASE(x) – Lower bound

• DTRACE_LQUANTIZE_LEVELS(x) – Number of steps between the lower and upper bounds

• DTRACE_LQUANTIZE_STEPS(x) – Step value between levels

The remaining values in the data are:

• The underflow bucket, which is the count of values less than the lower bound

• The buckets in the range of the linear quantization

• The overflow bucket, which is the count of values greater than or equal to the upper bound

lquantize() (dtrd_action == DTRACEAGG_LQUANTIZE)

The following diagram shows the layout.

Data Format for the lquantize() Action