Commands Reference, Volume 5

trcdead Command

Purpose

Extracts the trace buffer from a system dump image.

Syntax

trcdead [ -oFileName ] DumpImage

Description

The trcdead command extracts the eight active trace channels from a system dump. If the system halts while the trace facilities are active, the contents of the internal trace buffers are captured. If the -o flag is used, the trcdead command extracts the trace event data from the dump and writes it to the specified file. If the flag is not chosen, the command writes to the trace log file.

If multicpu trace buffering was requested for multiple CPUs using trace -C, those buffers are not dumped.

Use the trcrpt command to format a report from the trace log file.

Flag

-oFileName

Specifies the file to which data is written.

Examples

Note: To determine which example is more appropriate for your system, use the sysdumpdev command to display the current dump device assignments.

To extract information from a dump image written to a file named trace_extract, enter:
```
trcdead -o trace_extract /var/adm/ras/dumpfile
```
To extract information from a dump image written to a device, enter:
```
trcdead /dev/hd7
```

Files

/usr/bin/trcdead	Contains the trcdead command.
/var/adm/ras/dumpfile	Contains the default system dump file.
/var/adm/ras/trcfile	Contains the default system trace log.

Related Information

The errdead command, sysdumpdev command, trcnm command, trcrpt command.

The trace daemon.

The Trace Facility Overview in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.