HP Caliper Ktrace Features Guide

Table 3-1 ktracedump options (continued)

DescriptionOption

Turn on the specified column for printing. For example,: -J AbsTime

Column may be specified by name or number. AbsTime is column 12, so -J 12

would do the same thing as -J AbsTime.

The -J option takes an optional printf format string after the column name or

number. For example, "-J AbsSec%16.9lf" tells ktracedump to show the

AbsSec (Absolute Time in seconds) column as a 16 character wide column with 9

places after the decimal, meaning accuracy to the nanosecond.

J col%format

Do not show this column number or name in the output.

For example: -j PSR -j SpnD

j column

Sort the traces by the specified column name or number. Column name AbsTime

or AbsSec will sort by timestamp. Column name Seq or ZSeq will sort by sequence

number.

The default sort order is first by CPU primary, and AbsTime (timestamp)

secondary. When a sort option is specified, the elapsed time data (ElTime, ElUSec)

will reflect the new sort order.

S column

Print the arguments. Show columns arg0, arg1, arg2, and arg3 in the trace output.a

Print the globals. Show columns global0, global1, global2, and global3 in the trace

output.

Show all the columns (all fields of trace data) in the ktracedump output.

Do not print the list of traces. Use -N when you’re interested in printing just the

function list (e.g. ktracedump -DNF) and not all the traces which take time and

space to show. Also, you can use ktracedump-DN if you want to see only the

ktracedump header information (processor speed, memory usage).

Print the installed function list. Show the current tfe list, that is, the list of functions

that ktracer will trace when active. -DNF is used to print the function list on a

live system. -mNF will print the list of functions that ktracer had installed at the

time the dump was captured.

X is for extended functionality. The aN extension enables the reporting of up to 8

function arguments. a is short for arg; N is an integer arg count between 1 and 8.

11.31 1003 PHKL_40202 delivers the capability to trace up to 8 function arguments,

namely, arg0 through arg7, on Integrity hardware. If kernel support for 8 args is

not present, only 4 args maximum will be displayed.

Existing ktracedump options such as -A and -a will show just arg0 through arg3

for compatibility.

Specify -X a8 to show columns for arg0 through arg7 in the ktracedump output.

X aN

Using ktracedump

ktracer uses circular buffers. The oldest data will be overwritten by the newest data

when ktracer is active. Once the oldest data is overwritten, it is no longer available

Syntax 29