Adds, replaces, or deletes trace report format templates.
trcupdate [ -o ] [ -t File ] [ -v ] [ -x IDList ] [ File ]
The trcupdate command adds, replaces, or deletes trace report format templates in the /etc/trcfmt or the /etc/trcfmt.Z file. When the /etc/trcfmt.Z file is used, the trcupdate command uncompresses the file, updates it, and recompresses it. The trcupdate command creates an "undo" file named File.undo.trc in the specified directory.
The trcupdate command adds the extension .trc to the file name and reads update commands from that file. The undo file is input to the trcupdate command if the -o (override) flag is specified. When the -o flag is specified, the trcupdate command undoes the changes previously made to the file.
The first field of each template contains an operator:
The input to the trcupdate command must contain the following as the first line:
* /etc/trcfmt
The following is a sample trace file:
* /etc/trcfmt + 15A 1.0 new_fmt - 1B3 - A14
When adding or replacing, the trcupdate command compares the version numbers of each input template with the version number of the template with the same hook ID. If the version number of the input template is later than the version of the existing template, the trcupdate command replaces the old template with the input template. If a template does not exist, then the input template is added to the file.
The trcupdate command will not modify the /etc/trcfmt file if a syntax error is detected in the update file.
Access Control: Only the root user can run this command.
trcupdate * /etc/trcfmt + 15A 1.0 new_fmt
trcupdate * /etc/trcfmt - 15A 1.0 new_fmt
trcupdate * /etc/trcfmt + 15A 1.0 new_fmt
/usr/bin/trcupdate | Contains the trcupdate command. |
/etc/trcfmt | Contains the trace format file. |
/usr/include/sys/trcmacros.h | Defines trchook and utrchook macros. |
The trcdead command, trcrpt command.
The trace daemon.
The trcfmt file format.
The Trace Facility Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.