AIX命令参考大全,卷 2,d - h - fcstkrpt 命令

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

AIX命令参考大全,卷 2,d - h

fcstkrpt 命令

用途

显示 FFDC 错误堆栈文件的内容。

语法

/usr/sbin/rsct/bin/fcstkrpt { [-a] [-p | -r] { -f FFDC_Failure_Identifier [ -i ] | -s FFDC_Error_Stack_File_Name } } | [-h ]

描述

fcstkrpt 读取已经存在的 FFDC 错误堆栈文件并且向标准输出设备上显示它的内容。FFDC 错误堆栈文件通过文件名称本身指定,或者通过引用文件范围内特定记录的 FFDC 故障标识符来指定。

从 FFDC 错误堆栈得到的信息可以以下面两种格式中的一种来显示:通过相关故障情况(缺省值)或者通过软件层

标志

-a
指出对于 FFDC 错误堆栈中的条目所有将要显示的信息。缺省的操作就是显示记录时间戳记和事件的描述。
-f
指定 FFDC 故障标识符以便能够在定位 FFDC 错误堆栈的时候使用。fcstkrpt 解码了 FFDC 故障标识,定位与 FFDC 故障标识相关的 FFDC 错误堆栈并且处理 FFDC 错误堆栈。通过这个标志仅仅能指定一个 FFDC 故障标识。
-h
向标准输出设备上显示帮助信息并退出。不管指定的选项,不执行其它处理。
-i
仅仅显示与通过 -f 标志确定的特定故障报告相关的信息。在缺省情况下,显示所有在 FFDC 错误堆栈中的记录。
-p
沿着进程方向显示 FFDC 错误堆栈的信息。输出是有序的因此能够反映进程创建的顺序(父子关系)。首先显示子进程信息,紧跟着是父进程信息。这个视图被用来理解哪些事件先发生,哪些事件是由于它们而发生的。
-r
按照事件的关系显示 FFDC 错误堆栈中的信息。提供事件以及与之相关的事件。这个视图被用来理解哪些事件是由于其它事件的发生而发生的。此为缺省设置。
-s
指定要被检查的 FFDC 错误堆栈名称。这个名称可能是绝对的或者是相对的 FFDC 错误堆栈路径名称。只有一个 FFDC 错误堆栈文件名称可以通过这个标志来指定。如果用到了一个相对的文件名称,这个文件被认为是定位在节点的 /var/adm/ffdc/stacks 目录中,这里驻留着文件。

参数

FFDC_Failure_ID
指定故障的 FFDC 故障标识来开始报告。fcreport 将会试图为此故障获得故障信息,以及这个报告列出的作为相关故障的任何故障。只有一个 FFDC 故障标识可以提供给这个命令。

安全性

fcreport 利用 rsh 来获得也许驻留在远程节点上的故障报告。用户必须有足够的权限来执行用于远程节点的 rsh 命令。如果用户没有这个许可,只要它们在本地节点存在,fcreport 就只能追踪到相关故障的列表。

退出状态

fcstkrpt 完成之后会给出下面这些整型退出状态码:

0
FFDC 错误堆栈成功的被定位,并且已经将内容显示到了标准输出设备上。
2
显示帮助信息并结束进程。
12
指定的选项无效。
14
没有信息写入标准输出设备。使用了 -f 选项并且“FFDC 故障标识”参数是非法的。
20
没有信息写入标准输出设备。使用了 -s 选项并且没有找到 FFDC 错误堆栈文件参数。
27
没有信息写入标准输出设备。调用者提供了一个合法的 FFDC 故障标识,但是通过 FFDC 故障标识引用的文件没有在这个节点上记录。利用 fcdecode 命令来定位节点,这个节点上驻留着 FFDC 错误堆栈。
81
没有信息写入标准输出设备。当向标准输出设备上写入信息的时候产生了故障。应用程序应该得出结论:标准输出设备不能接受输出。
85
没有信息写入标准输出设备。调用者提供了一个合法的 FFDC 故障标识,但是 FFDC 故障标识引用的文件却不存在。

示例

为了获得存储在 FFDC 错误堆栈文件 /var/adm/ffdc/stacks/myprog.562.19981001143052 中信息的一个简短报告:

$ fcstkrpt -r -s myprog.562.19981001143052

为了获得包含在 FFDC 错误堆栈中信息的详细报告,在这里记录了 .3Iv04ZVVfvp.wtY0xRXQ7.................... 错误故障标识符,并且以父子顺序显示了这些信息。

$ fcstkrpt -p -f .3Iv04ZVVfvp.wtY0xRXQ7....................

相关信息

命令:fcclearfcdecodefcdispfidfcfilterfcpushstkfcreport

子例程:fc_push_stack(请参考 RSCT First Failure Data Capture Programming Guide and Reference

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