trcupdate(1) — AIX PS/2 1.2.1



TRCUPDATE(1,C)              AIX Commands Reference               TRCUPDATE(1,C)



-------------------------------------------------------------------------------
trcupdate



PURPOSE

Updates trace format templates.

SYNTAX


                    +------+
trcupdate -- file --|      |---|
                    +- -o -+


DESCRIPTION

The trcupdate command adds, replaces, or deletes trace report format templates
in the files /etc/trcfmt and /usr/adm/ras/.trcevents and event types in the
file /etc/trcprofile.  trcupdate creates three undo files in the current
directory named file.undo.trc, .trcevents.undo.evt, and file.undo.pro.  These
undo files can be used as input to trcupdate with the -o (override) flag to
undo the changes the trcupdate command has just made.

The trcupdate command reads three files named file.trc, file.evt, and file.pro.
The trc file contains trace format templates; the evt file contains trace event
types and their corresponding hook IDs; the pro file contains the event type
line for the trace profile.

The first field of each template contains an operator:

+  To add or replace a template

-  To delete a template.

If the operation is +, the following fields contain the template to be
replaced.  The hook ID of the template is also added to the
/usr/adm/ras/.trcevents file, and the event type line is added to the trace
profile /etc/trcprofile.  If the operation is a -, the second field contains
the hook ID of the template to delete.  That hook ID is also deleted in
/usr/adm/ras/.trcevents, and the event type line is deleted from
/etc/trcprofile.

When adding or replacing, the trcupdate command compares the version numbers of
each input template with the version number of the existing template of the
same hook IDs.  If the version number of the input template is later, it
replaces the old template with the input template.  If the template does not
already exist, it is added to the file.  The input file must contain the
identifier "* /etc/trcfmt" on the first line.




Processed November 8, 1990      TRCUPDATE(1,C)                                1



TRCUPDATE(1,C)              AIX Commands Reference               TRCUPDATE(1,C)



The file.evt file contains a table of trace system event types and hook IDs
that fall under these types.  trcupdate reads in the file
/usr/adm/ras/.trcevents and adds in any hook IDs from file.evt that are not
already accounted for or reassigns/deletes hook IDs to the event type given in
the update file.  The first line of the event/hook update file must be:    "*
/ras/.trcevents" or trcupdate rejects the input file.

The file.pro contains the lines that are to be added to or deleted from
/etc/trcprofile.  trcupdate reads /etc/trcprofile and adds or deletes the
specified event type line from file.pro.  The first line of the event type file
must be:  "* /etc/trcprofile"  or trcupdate rejects the input file.

FLAGS

-o Does no version number checking.

EXAMPLES

  1. The following is a sample trc file:

      * /etc/trcfmt
      + 355 1.0 new_fmt
      - 351
      - 352

  2. The following is a sample evt file:

      * ras/.trcevents
      350 355 356 357

FILES

/etc/trcfmt
/usr/adm/ras/.trcevents
file.evt
file.undo.evt
file.trc
file.undo.trc
file.pro
file.undo.pro

RELATED INFORMATION

See the following command:  "trcrpt."











Processed November 8, 1990      TRCUPDATE(1,C)                                2

Museum

Related Articles