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

fcreport 命令

用途

定位并显示故障和与该故障相关的任何故障的报告。

语法

/usr/sbin/rsct/bin/fcreport { [ -a ] FFDC_Failure_ID } | -h

描述

fcreport 对 FFDC 故障标识符进行解码，并且获取由它指定的故障报告。该命令还会检查是否存在故障同这个 FFDC 故障标识符相关联，如果是这样的话，就会获取这个故障的报告。该命令会继续检查它为相关故障定位的每一个故障的报告并且继续获取关于相关故障的报告，直到遇到下列情况中的一个：

• 没有检测到更多的相关故障。
• 找不到相关故障的报告。这种情况会在当相关的故障报告在远程节点上驻留，而在这个时候不能到达远程节点或者故障的记录已经从它驻留的节点那里除去了的时候产生。

利用该命令，用户可以获取导致特定故障的整个故障列表报告。如果故障不是由提供给命令的初始故障引起的话，fcreport 不能对故障做出定位报告；它只能获取引起故障的故障报告。

标志

-a

显示包含在故障报告中的所有信息。缺省显示节点的网络地址（在此节点产生了故障报告）、故障报告的时间戳记和在故障报告中记录的事件描述。

-h

向标准输出设备上显示帮助信息并退出。不管指定的选项，不执行其它的处理。

参数

FFDC_Failure_ID

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

安全性

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

退出状态

fcreport 一结束就会产生下列退出状态码中的一种：

0

为 FFDC 故障标识符提供的定位和显示的故障报告。零或者更多相关的故障报告可能已经被定位和显示了。

2

显示帮助信息并结束进程。

10

没有提供需求的选项或者参数。

11

一个后来的 FFDC 软件发行版产生了提供给该命令的 FFDC 故障标识符。命令不能正确解释这个标识符。

12

向该命令指定了未知的选项。

20

FFDC 故障标识符指的是系统上“FFDC 错误堆栈”中的条目，但是“FFDC 错误堆栈”文件不能被访问。文件可能已经除去，或者为了防止访问这个文件这个文件的许可可能已经被更改。

27

向此命令提供的 FFDC 故障标识符不是合法的标识符。

示例

考虑下面这种情况，几个进程按下面这种父子顺序被创建：

                            PID  562
                                .
                                .
                            PID = 785
                             .      .
                           .          .
                         .              .
                   PID = 2024          PID = 1042
                   .     .
                 .         .
               .             .
          PID = 981     PID = 5012

在这个示例中，进程 785 产生了 FFDC 故障标识符 .3Iv04ZVVfvp.wtY0xRXQ7.................... 同时将它传递回进程 562。为了获得 FFDC 故障标识符 .3Iv04ZVVfvp.wtY0xRXQ7.................... 的详细报告 和导致这个特定故障的先前的故障：

$ fcreport -a .3Iv04ZVVfvp.wtY0xRXQ7....................

这个报告将会包括指定的 FFDC 故障标识符详细的信息，也包括可能引起它的进程 2024、1042、981 和 5012 中的故障的报告。报告将不会包括进程 562 中的故障，因为这些故障也许是进程 785 故障的结果。

相关信息

命令：fcclear、fcdecode、fcdispfid、fcfilter、fclogerr、fcpushstk、fcstkrpt

子例程：fc_log_error、fc_push_stack（参考 RSCT First Failure Data Capture Programming Guide and Reference）