trcupdate 命令

用途

添加、替换或删除跟踪报告格式模板。

语法

trcupdate [ -o ] [ -t File ] [-v ] [ -x IDList ] [ File ]

描述

trcupdate 命令添加、替换或删除 /etc/trcfmt 或 /etc/trcfmt.Z 文件中的跟踪报告格式模板。使用 /etc/trcfmt.Z 文件时，trcupdate 命令解压缩、更新和再压缩文件。 trcupdate 命令在指定目录中创建一个名为 File.undo.trc 的“撤销”文件。

trcupdate 命令为文件名添加 .trc 后缀并从该文件中读取更新命令。如果指定 -o（覆盖）标志，撤销文件输入到 trcupdate 命令。指定 -o 标志，trcupdate 命令撤销文件前面所做改动。

每个模板第一个字段包含一个运算符：

项	描述
+	加号表示要添加或替换模板。此运算符后的字段包含要替换的模板。
-	减号表示要删除模板。此运算符后的字段包含要删除模板的挂钩标识。操作按出现顺序执行。

对 trcupdate 命令的输入应包含以下内容作为第一行：

* /etc/trcfmt

以下是一个样本跟踪文件：

* /etc/trcfmt
+ 15A 1.0 new_fmt
- 1B3
- A14

添加或替换时，trcupdate 命令将每一输入模板的版本号和相同挂钩标识模板的版本号相比较。如果输入模板的版本号大于或等于现有模板的版本号，trcupdate 命令将用输入模板替换旧模板。如果模板不存在，那么在文件中添加输入模板。

更新文件中检测到语法错误时，trcupdate 命令不修改 /etc/trcfmt 文件。

标志

项	描述
-O	不验证任一模板版本号而以输入模板覆盖旧模板。
-t 文件	指定一个文件而不是 /etc/trcfmt 或 /etc/trcfmt.Z 文件用作模板文件。
-v	每个文件打开时显示文件名。
-x IDList	从模板文件中抽取 IDList 中的指定模板并写到标准输出。 IDList 参数列出挂钩标识。

安全性

访问控制：无，但必须具有对正在更改的模板文件的写权限。缺省值为 /etc/trcfmt。

示例

要添加模板，请输入以下命令:
```
trcupdate
* /etc/trcfmt
+ 15A 1.0 new_fmt
```
提示：在AIX® 6.1及更高版本中，这相当于：
```
trcupdate
* /etc/trcfmt
+ 15A0 1.0 new_fmt
```
要删除模板，请输入以下命令:
```
trcupdate
* /etc/trcfmt
- 15A 1.0 new_fmt
```
提示: 在 AIX 6.1 及更高版本中，这等同于:
```
trcupdate
* /etc/trcfmt
- 15A0 1.0 new_fmt
```
要替换模板，请输入以下命令:
```
trcupdate
* /etc/trcfmt
+ 15A 1.0 new_fmt
```
提示: 在 AIX 6.1 及更高版本中，这等同于:
```
trcupdate
* /etc/trcfmt
+ 15A0 1.0 new_fmt
```
在 AIX 6.1 和更高版本中，要为挂钩标识 0AB0添加模板，请输入以下命令:
```
trcupdate
* /etc/trcfmt
+ 0AB0 1.0 new_fmt
```
以上命令等价于下列命令：
```
trcupdate
* /etc/trcfmt
+0AB 1.0 new_fmt
```
在 AIX 6.1 及更高版本中，要为挂钩标识 1AB1添加模板，请输入以下命令:
```
trcupdate
* /etc/trcfmt
+ 1AB1 1.0 new_fmt
```

文件

项	描述
/ usr / bin / trcupdate	包含 trcupdate 命令。
/etc/trcfmt	包含跟踪格式文件。
/usr/include/sys/trcmacros.h	定义 trchook 和 utrchook 宏。