printa Action

printa
void printa(aggregation)
void printa(string format, aggregation)

The printa action enables you to display and format aggregations. For more information about aggregations, see DTrace Aggregations. If a format is not provided, printa only traces a directive to the DTrace consumer that the specified aggregation should be processed and displayed using the default format. If a format is provided, the aggregation will be formatted as specified. For more information about the printa format string, see Output Formatting in DTrace.

printa only traces a directive that the aggregation should be processed by the DTrace consumer. It does not process the aggregation in the kernel. Therefore, the time between the tracing of the printa directive and the actual processing of the directive depends on the factors that affect buffer processing. These factors include the aggregation rate, the buffering policy and, if the buffering policy is switching, the rate at which buffers are switched. For more information, see DTrace Aggregations and DTrace Buffers and Buffering.