trc subcommand
The trc subcommand is used to merge multiple Component Trace (CT) and Lightweight Memory Trace (LMT) buffers in the KDB Kernel Debugger.
Format
trc { -c component[+] | -l component alias[+] | -m {rare | common | all }} [ -C cpu0,… ] [ -t TID ] [ -j { hook ID, ... | hook:subhook } ] [ -s tb0 ] [ -e tb1 ] [ -v ]
trc all [-C cpu0,… ] [ -t TID ] [ -j { hook ID, ... | hook:subhook } ] [ -s tb0 ] [ -e tb1 ] [-v ]
Parameters
| Item | Description |
|---|---|
| -c component[+] | Specify a RAS component by path name. Can optionally include all sub-components of this component by appending the '+' symbol after the path name. Multiple -c parameters are allowed. Multiple components can be specified with a single -c flag, provided that they are comma-separated. |
| -l component alias[+] | Specify a RAS component by alias name. Can optionally include all sub-components of this component by appending the '+' symbol after the path name. Multiple -l parameters are allowed. Multiple aliases can be specified with a single -l flag, provided that they are comma-separated. |
| -m { rare | common | all } | Specify an LMT buffer type. |
| all | Merge all LMT and CT buffers in the system. |
| -C cpu0,… | Restrict trace entries displayed to those that have occurred on the specified processors. If -C is not specified, trace entries from all processors are included. |
| -t TID | Restrict trace entries displayed to those that have the specified thread ID. |
| -j { hook ID, ... | hook:subhook } | Restrict trace entries displayed to those that have the specified hook ID(s) or to those that have specified the hook and subhook ID. |
| -s tb0 | Restrict trace entries displayed to those that have a time base after what is specified. |
| -e tb1 | Restrict trace entries displayed to those that have a time base before what is specified. |
| -v | Display more descriptive information about trace data. |
The trc subcommand can be used to merge multiple CT buffers and multiple LMT buffers. CT buffers can be specified with component path name or component alias name. Components can also be specified recursively from another component. LMT buffers can be limited to only rare or common buffers or not limited at all. Traces can be filtered with any of the following: processor, ID, ThreadID, multiple hook IDs, a specific hook and subhook, start time and end time. A verbose view is also available for extra trace information. You can also specify to merge all CT and LMT buffers together with the trc all syntax. A maximum of 512 CT buffers can be merged with any number of LMT buffers.
If a component is specified without recursion (the + flag) and is not trace aware, the component will not be included and a warning will be printed. If a component is trace aware but has an empty buffer, it will not be included and a warning will be printed. If the number of CT components specified exceeds the maximum limit, only those under the limit will be merged.
Other
No aliases.
Examples
- To combine all vmm and livedump Component Trace buffers with LMT
common buffer data and restrict output to processor 2 and processor
4, type the following:
trc –c vmm+ -l livedump –m common –C 2,4 - To extract all vmm Component Trace data with LMT rare buffers
for hook 100 and 200, TID 0x1003, start timestamp 0x3ABCDEF00, and
end timestamp 0x3FEDCBA00, type the following:
trc –c vmm+ -m rare –j 100,200 –t 1003 –s 3ABCDEF00 –e 3FEDCBA00 - To extract all livedump Component Trace data with hook id 0x5CB
and subhook 0x25, type the following:
trc –l livedump –j 5CB:25