void printa(aggregation
) void printa(stringformat
,aggregation
)
The printa
action enables you to display
and format aggregations. See Chapter 3, Aggregations for more
details. If format
is not
specified, printa
traces only a directive
to the DTrace consumer for which the specified aggregation
should be processed and is displayed using the default format.
If format
is specified, the
aggregation is formatted. See Section 6.2, “printa Action”
for a detailed description of the printa
format string.
When printa
traces only 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 factors that
affect buffer processing, which include the following: the
aggregation rate, the buffering policy (and if the buffering
policy is switching
), and the rate at which
buffers are switched. See Chapter 3, Aggregations and
Chapter 5, Buffers and Buffering for detailed
descriptions.