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

fcfilter 命令

用途

在一个文件或标准输入中发现并显示任何一个首次故障数据捕捉（FFDC）故障标识符。可能指定了多个文件。

语法

/usr/sbin/rsct/bin/fcfilter [ file_name ] [. . . ]

描述

该命令扫描作为参数列出的任何文件，以获得首次故障数据捕捉（FFDC）故障标识符。如果没有提供一个文件名作为参数，该命令从标准输入中搜索 FFDC 故障标识符。如果检测到一个故障标识符，fcfilter 在标准输出上该行显示标识符。

脚本程序能使用 fcfilter 命令获取子进程通过标准错误设备返回的 FFDC 故障标识符。

如果 fcfilter 在输入中检测到多于一个的 FFDC 故障标识符，该命令将显示所有被发现的 FFDC 故障标识符，在每一输出行中显示一个。

标志

-h

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

-q

隐藏该命令产生的警告消息。如果没有提供该命令选项，当检测到一个无效的 FFDC 故障标识符时，该命令将显示信息。

参数

file_name

用于搜索一个 FFDC 故障标识符的文件名。可能提供多于一个的文件名。如果没有给出文件名，则fcfilter 从标准输入中读入。

退出状态

fcfilter 在结束时返回下列整数形式的状态代码：

0

fcfilter 结束执行。该退出状态并不一定表示检测到了任何的 FFDC 故障标识符。

> 0

fcfilter 被一个信号所中断或停止。退出状态是一个整数信号值，正是该信号停止了该命令的运行。

示例

FFDC 故障标识符由一个 base-64 数值表示，该数值按从右往左的顺序读入。每一个点表示一个前导的零。要获得 mycmd 命令运行所产生的所有 FFDC 故障标识符的列表：

 mycmd 2> /tmp/errout
 fcfilter /tmp/errout
/.00...JMr4r.p9E.xRXQ7....................
/.00...JMr4r.pMx.xRXQ7....................

要获得来自父脚本程序中一个子进程的 FFDC 故障标识符，该脚本程序可如下使用 fcfilter 命令：

RESULTS=$(mychild 2> /tmp/errout)
if (($? != 0))               # mychild ended in failure, get FFDC ID
则    cat /tmp/errout | fcfilter | read FIRST_FFDCID
else
    rm -f /tmp/errout
fi

相关信息

命令：fcdispfid、fclogerr、fcpushstk、 fcreport 和 fcstkrpt

子例程：fc_display_fid, fc_log_error, fc_push_stack （请参考 RSCT 首次故障数据捕捉编程指南和参考大全）