AIX命令参考大全,卷 5,s - u - trcrpt 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全,卷 5,s - u

trcrpt 命令

用途

格式化来自跟踪日志的报告。

语法

trcrpt-c ] [ -C [ CPUList | all ]] [  -d List ] [ -D Event-group-list ] [  -e Date ] [ -G ] [ -h ] [  -j ] [ -k List ] [ -K Group-list ] [ -n Name ] [  -o File ] [  -p List ] [  -r ] [  -s Date ] [  -t File ] [  -T List ] [  -v ] [ -O Options ] [  -x ] [ File ]

描述

trcrpt 命令读取 File 参数所指定的跟踪日志,格式化跟踪记录,并将报告写入标准输出。系统根据缺省文件 /var/adm/ras/trcfile 生成一个跟踪报告,但你也可以指定一个备用 File 参数。

可以通过输入 SMIT 快捷路径使用系统管理接口工具(SMIT)运行 trcrpt 命令:

smit trcrpt

标志

-c 检查模板文件的语法错误。
-C [ CPUList | all ] 使用 trace -C 为多 CPU 跟踪生成报告。多个 CPU 可以用逗号隔开,或包含在双引号中然后用逗号或空格隔开。要生成所有 CPU 的报告,请指定 trace -C all 命令。-C 标志是不必要的,除非你只想看到被跟踪 CPU 的一个子集,或者在报告中显示 CPU 号。如果没有指定 -C,而且该跟踪为多 CPU 跟踪,则 trcrpt 生成所有 CPU 的跟踪报告,对每个挂钩并不显示 CPU 号,除非你指定 -O cpu=on
-d List 将报告限制在 List 变量指定的挂钩标识范围中。List 参数项可以用逗号隔开,或包含在双引号中并用逗号或空格隔开。
-D Event-group-list 将报告限制在事件组列表里的挂钩标识,加上用 -d 标志指定的任意挂钩标识。列表参数项可以用逗号隔开,或包含在双引号中然后用逗号或空格隔开。事件组 在“调试和性能跟踪”中描述。
-e Date 以指定日期或之前的时间项结束报告时间。Date 变量的格式为 mmddhhmmssyy(月、日、时、分、秒以及年)。只有当开始和停止跟踪数据收集时,才在跟踪数据里记录日期和时间。如果您在一次跟踪对话期间多次停止和重新启动跟踪数据收集,每一次启动和停止跟踪数据收集时都会记录下日期和时间。将此标志与 -s 标志联合使用将跟踪限制在特定时间间隔期所收集的数据上。
注:
如果用 -C 指定 -e,则 -e 标志被忽略。
-G 列出所有事件组。组列表、每组的挂钩标识以及每组的描述都在标准输出中列出。
-h 省略跟踪报告的头信息,只将格式化过的跟踪条目写到标准输出。
-j 显示挂钩标识列表。trcrpt -j 命令可以与包括跟踪事件标识的 trace -j 命令或者不包括跟踪事件标识的 trace -k 命令一起使用。
-k List 从报告中排除 List 变量指定的挂钩标识。List 参数项可以用逗号隔开,或包含在双引号中并用逗号或空格隔开。
-K Event-group-list 从报告中排除 event-groups 列表中的挂钩标识,加上 -k 标志所指定的任意挂钩标识。列表参数项可以用逗号隔开,或包含在双引号中然后用逗号或空格隔开。事件组在“调试和性能跟踪”中描述。
-n Name 指定用于解释输出地址的内核名称列表文件。通常,在将一个跟踪日志文件移动到另外一个系统时会用到该标志。
-o File 将报告写入文件而不是标准输出。
-O Options 指定改变 trcrpt 命令内容和表示的选项。该选项的各个参数必须用逗号隔开。有效选项为:
2line=[on|off]
在报告里为每一个跟踪事件使用两行而不是一行。缺省值为 off
cpuid=[on|off]
在跟踪报告里显示物理处理器号。缺省值为 off
endtime=Seconds
显示指定秒数之前记录的事件的跟踪报告数据。秒数可以是整数或有理数表示。如果此选项与 starttime 选项同时使用,可以显示特定的范围。
exec=[on|off]
在跟踪报告里显示执行路径名。缺省值为 off
hist=[on|off]
记录每个挂钩标识遇到的实例数。此数据可用来生成直方图。缺省值为 off。此选项不可与任何其它选项同时运行。
ids=[on|off]
在跟踪报告的第一列显示跟踪挂钩标识号。缺省值为 on
pagesize=Number
控制跟踪报告每一页的行数,是 0 到 500 范围内的一个整数。每一页都有列标题。当缺省值被设为 0 时,没有分页符。
pid=[on|off]
显示跟踪报告里的进程标识。缺省值为 off
reportedcpus=[on | off ]
显示保留 CPU 的数量。此选项仅在多 CPU 跟踪中有意义,trace -C。例如,如果你在读一个拥有 4 个 CPU 的系统的报告,报告的 CPU 值 从 4 变成 3,那你就知道不再会报告关于该 CPU 的挂钩了。
 
starttime=Seconds
显示指定秒数之后记录的事件的跟踪报告数据。指定的秒数是从跟踪文件开始算起。秒数可以是整数或有理数表示。如果此选项与 endtime 选项同时使用,可以显示特定的范围。
svc=[on|off]
显示跟踪报告中系统调用的值。缺省值为 off
tid=[on|off]
显示跟踪报告里的进程标识。缺省值为 off
timestamp=[0|1|2|3]
                         
控制对时间戳记的报告,该时间戳记与跟踪报告中的事件相关联。它的值可能是:
0
                         
用时自跟踪启动之时起开始记时,记录距前一次事件的时间变化量。用时以秒计而时间变化量则以毫秒计。两个值都报告最近的时间(以纳秒计)。此为缺省设置。
1
短期用时。只报告从跟踪启动之时起的用时(以秒计)。用时报告最近的时间(以微秒计)。
2
微秒时间变化量。这就像 0,除了间隔时间是以微妙计以外,报告最近的时间(以微秒计)。
3
没有时间戳记。
-p List List 变量指定的每一个事件报告进程标识。List 变量可以是进程标识列表或进程名列表。以数字字符开头的列表项被认为是进程标识。列表项可以用逗号隔开,或包含在双引号中然后用逗号或空格隔开。
-r 输出未格式化(原始)的跟踪条目,并将跟踪日志的内容逐条写入标准输出。使用 -h-r 标志排除报头。要在一个多 CPU 跟踪中获取 CPU 原始报告,请使用 -r-C 标志。
-s Date 以记录时间结束报告,或在指定日期之前。Date 变量的格式为 mmddhhmmssyy(月、日、时、分、秒以及年)。只有当开始和停止跟踪数据收集时,才在跟踪数据里记录日期和时间。如果您在一次跟踪对话期间多次停止和重新启动跟踪数据收集,每一次启动和停止跟踪数据收集时都会记录下日期和时间。将此标志与 -e 标志联合使用将跟踪限制在特定时间间隔期所收集的数据上。
注:
如果用 -C 指定 -s,则 -s 标志被忽略。
-t File File 变量所指定的文件用作模板文件。缺省为 /etc/trcfmt 文件。
-T List 将报告限制在 List 参数所指定的内核线程标识。列表项为逗号隔开的内核线程标识。以内核线程标识开头的列表将报告的内容限制为列表中的所有内核线程标识。以 !(感叹号)后跟内核线程标识作为开头的列表将报告的内容限制为不在列表中的所有内核线程标识。
-v 在文件被打开时打印文件名。更改为详细设置。
-x 显示执行路径名和系统调用值。

示例

  1. 要格式化跟踪日志文件并打印结果,请输入:

    trcrpt | qprt
  2. 要将跟踪报告发送给 /tmp/newfile 文件,请输入:

    trcrpt -o /tmp/newfile
  3. 要显示跟踪报告中的进程标识和执行路径名,请输入:

    trcrpt -O pid=on,exec=on
  4. 要创建跟踪标识直方图数据,请输入:

    trcrpt -O hist=on
  5. 要产生所有事件组列表,请输入:

    trcrpt -G
    此报告的格式显示在 trcevgrp 命令下。

文件

/usr/bin/trcrpt 包含 trcrpt 命令。
/var/adm/ras/trcfile 包含缺省日志文件。
/etc/trcfmt 包含跟踪格式文件。

相关信息

trcdead 命令、trcevgrp 命令、trcnm 命令、trcstop 命令和 trcupdate 命令。

trace 守护进程。

trcfmt 文件格式。

AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs 中的 Trace Facility Overview

《AIX 5L V5.2 性能管理指南》中的『监视和调节命令和子例程』

AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts 中的 Debug and Performance Tracing。

[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]