ktracedump.1m (2010 09)

k
ktracedump(1M) ktracedump(1M)
ElTime Elapsed Time (ElTime) measures the time that elapsed, in iticks, between when the previous
trace record was captured and when the current trace record was captured. Because trace
points exist only at function entry points, ElTime measures elapsed time from Function
ENTRY to Function ENTRY. Although users want to interpret ElTime and ElUSec as the
length of time spent within the Function, from ENTRY to EXIT, that is not what ElTime is. A
highly desired future enhancement is for ktracer
to capture a timestamp and return value
at function exit points. Until that enhancement is released, ElTime and ElUSec will only
report elapsed time from Function entry to Function entry.
ElTime is computed from AbsTime in the current trace record minus AbsTime in the previous
trace record in the trace buffer. For the first record in the trace buffer, ElTime is reported as
zero.
ElUSec Elapsed Time in Microseconds (ElUSec) is the ElTime value converted from units of iticks to
microseconds.
PSR The PSR is the Processor Status Register, which is part of the Integrity processor system state
described in section 3.3.2 of the Intel IA-64 Architecture Software Developer’s Manual, Volume
2: IA-64 System Architecture on
http://www.intel.com/design/itanium/manuals/iiasdmanual.htm
The PSR column description is:
PSR - PSR pp/ic/pk/dt/i = pCPDI when on, _ off
The full 64-bit PSR value is captured in each trace record.
To compact a lot of PSR information into just 5 characters of data in the
PSR column, ktra-
cedump has adapted the following method, which is subject to future change.
If PSR.pp (priv perf monitor enable) is 1, show ’p’.
If PSR.ic (interrupt collection) is 1, show ’C’.
If PSR.pk (protection key enable) is 1, show ’P’.
If PSR.dt (data address translation) is 1, show ’D’.
If PSR.i (external interrupt enable) is 1, show ’I’.
If any of the above values is 0 rather than 1, then show the underscore character ’_’ rather
than the letter ’p’, ’C’, ’P’, ’D’, or ’I’.
To illustrate further, seeing the characters pCPD_ in the
PSR column, would indicate that
PSR.pp, PSR.ic, PSR.pk and PSR.dt are 1. The _ instead of I at the end means that PSR.i
was disabled at the time the trace record was captured.
TPR The Task Priority Register (TPR) is an interrupt control register (cr66) described in section
10.3.3 of Intel IA-64 Architecture Software Developer’s Manual Volume 2.
arg0 Argument 0 is the first parameter passed to the traced function (callee). Based on the default
arg0 format, %#18lx, arg0 is shown as a 64 bit hexadecimal value. To show arg0 as a decimal
value, specify -Jarg0%18ld on the command line. The %#18lx format is explained as fol-
lows:
% Introduces a printf() format specifier.
# Prints the leading 0x prefix.
18 Makes the column 18 characters wide.
l Specifies long (64-bit rather than 32-bit).
x Prints in hexadecimal (base16).
%18ld differs from %#18lx in that there is no leading # or 0x, and the d means decimal
(base10).
arg1 Argument 1 is the second parameter passed to the traced function.
arg2 Argument 2 is the third parameter passed to the traced function.
arg3 Argument 3 is the fourth parameter passed to the traced function.
SymArg0 Symbolic argument 0 is a symbolic translation of arg0, the first parameter passed to the traced
function (callee). SymArg0 will report the symbol name, lock name, syscall name, trap name,
HP-UX 11i Version 3: September 2010 − 7 − Hewlett-Packard Company 7