Oracle Solaris Studio 12.2 Discover 和 Uncover 用户指南

命令行选项

您可以将以下选项与 discover 命令结合使用来校验二进制文件。

输出选项

-o file

将校验过的二进制文件写入 file。缺省情况下,校验过的二进制文件会覆写输入的二进制文件。

-w text_file

将 Discover 的二进制文件报告写入 text_file。该文件是在您运行校验过的二进制文件时创建的。如果 text_file 是相对路径名,则该文件位于与您运行校验过的二进制文件时所在工作目录相对的位置。要使每次运行二进制文件时该文件名均具有唯一性,请在文件名中添加字符串 %p,要求 Discover 运行时包含进程 ID。例如,选项 -w report.%p.txt 将生成一个文件名为 report.process_id.txt 的报告文件。如果文件名中包含多处 %p,只有第一个实例会替换为进程 ID。

如果不指定此选项或 -H 选项,会以 HTML 格式将报告写入 output_file.html,其中 output_file 是校验过的二进制文件的基本名称。该文件位于您运行校验过的二进制文件时所在的工作目录中。

您可以同时指定此选项和 -H 选项,同时以文本和 HTML 格式写入报告。

-H html_file

以 HTML 格式将 Discover 的二进制文件报告写入 html_file。此文件是在您运行校验过的二进制文件时创建的。如果 html_file 是相对路径名,则该文件位于与您运行校验过的二进制文件时所在工作目录相对的位置。要使每次运行二进制文件时该文件名均具有唯一性,请在文件名中添加字符串 %p,要求 Discover 运行时包含进程 ID。例如,选项 -H report.%p.html 会生成一个文件名为 report.process_id.html 的报告文件。如果文件名中包含多处 %p,只有第一个实例会替换为进程 ID。

如果不指定此选项或 -w 选项,会以 HTML 格式将报告写入 output_file.html,其中 output_file 是校验过的二进制文件的基本名称。该文件位于您运行校验过的二进制文件时所在的工作目录中。

您可以同时指定此选项和 -w 选项,同时以文本和 HTML 格式写入报告。

-e n

仅在报告中显示 n 个内存错误(缺省情况下显示所有错误)。

-E n

仅在报告中显示 n 个内存泄漏(缺省情况下显示 100 个)。

-f

在报告中显示偏移(缺省情况下隐藏偏移)。

-m

在报告中显示重整名称(缺省情况下显示取消重整名称)。

-S n

仅在报告中显示 n 个栈帧(缺省情况下显示 8 个)。

校验选项

-l

在轻量模式下运行 Discover。使用此选项可以更快地执行程序,并且无需特意根据必须正确准备二进制文件中的说明准备程序,但只能检测到有限数量的错误。

-i

使用线程分析器校验数据争用检测。如果使用此选项,仅在运行时执行数据争用检测,而不执行其他任何内存检查。必须使用 collect 命令运行校验过的二进制文件,以生成可以在性能分析器中查看的实验(请参见《Oracle Solaris Studio 12.2:线程分析器用户指南》)。

-s

尝试校验一个无法校验的二进制文件时发出警告,但不标出错误。

-T

仅校验命名的二进制文件。在运行时不校验任何相关的共享库。

-N library

不校验与前缀 library 匹配的任何相关共享库。如果库名称的前几个字符与 library 匹配,则忽略该库。如果 library 以 / 开头,则根据库的绝对完整路径名进行匹配。否则,根据库的基本名称进行匹配。

-K

不读取 bit.rc 初始化文件(请参见bit.rc 初始化文件)。

缓存选项

-D cache_directory

cache_directory 用作存储缓存的校验过的二进制文件的根目录。缺省情况下,高速缓存目录为 $HOME/SUNW_Bit_Cache

-k

强制重新校验高速缓存中找到的所有库。

其他选项

-h-?

帮助。输出简短的用法消息并退出。

-v

详细。输出 Discover 正在执行的操作的日志。重复使用该选项可获得更多信息。

-V

输出 Discover 版本信息并退出。