Sun Studio 12:Fortran 编程指南

5.1.4.2 -Xlist 及其子选项

按下列规则合并子选项:

示例:以下两个命令行中的每一个执行相同的任务:


demo% f95  -Xlistc  -Xlist  any.f

demo% f95 - Xlistc  any.f

下表展示单独由这些基本的 -Xlist 子选项生成的报告:

表 5–1 基本的 Basic Xlist 子选项

生成的报告 

选项 

错误、列表、交叉引用 

–Xlist

仅错误 

–XlistE

仅错误以及源码列表 

–XlistL

仅错误以及交叉引用表

–XlistX

仅错误以及调用图

–Xlistc

下表展示所有 -Xlist 子选项。

表 5–2 -Xlist 子选项的完整列表

选项 

操作 

–Xlist无子选项

显示错误、列表和交叉引用表 

–Xlistc

显示调用图和错误

单独使用时,-Xlistc 不显示列表或交叉引用。它使用可打印字符以树的形式产生调用图。如果某些子例程未自 MAIN 中调用,会显示一个以上的图。单独打印每一个 BLOCKDATA,不连接到 MAIN

缺省时显示调用图。

–XlistE

显示错误

单独使用时,-XlistE 只显示跨例程错误而不显示列表或交叉引用。

–Xlisterr[nnn]

在检验报告中禁止错误 nnn

可使用 -Xlisterr 禁止来自列表或交叉引用的编号错误信息。

例如:-Xlisterr338 禁止错误消息 338。要禁止其他特定的错误,可重复使用该选项。如果未指定 nnn,会禁止所有错误消息。

–Xlistf

更快地产生输出 

可使用 -Xlistf 产生源文件列表和交叉检查报告,并在未完全编译的情况下检查源代码。

–Xlisth

显示来自交叉检查停止编译的错误 

使用 -Xlisth,如果在交叉检查程序时检测到错误,编译将会停止。此时,会将报告重定向到 stdout 而非 *.lst 文件。

–XlistI

列表和交叉检查 include 文件

如果 -XlistI 是唯一使用的子选项,会随 -Xlist 标准输出(行编号列表、错误消息和交叉引用表)一同显示或扫描 include 文件。

列表-如果未禁止列表,则会在适当位置列出 include 文件。文件会按其被包含的次数列出。这些文件是:源文件、#include 文件、INCLUDE 文件

交叉引用表-如果未禁止交叉引用表,会在生成交叉引用表时扫描下列所有文件:源文件、#include 文件、INCLUDE 文件

缺省时不显示 include 文件。

–XlistL

显示列表和错误

使用 -XlistL 仅产生列表和跨例程错误列表。该子选项本身并不显示交叉引用表。缺省时显示列表和交叉引用表

–Xlistln

设置分页符 

可使用 -Xlistl 将页长度设置为缺省页面大小以外的值。例如,-Xlistl45 将页长度设置为 45 行。缺省值为 66。

如果使 n=0 (-Xlistl0 ),该选项将显示不带分页符的列表和交叉引用,以便于屏幕查看。

-XlistMP

(SPARC) 检查 OpenMP 指令的一致性

可使用 -XlistMP 报告源代码文件中指定的 OpenMP 指令的不一致性。有关详细信息,另请参见《OpenMP API 用户指南》。

–Xlisto name

指定 -Xlist 输出报告文件

可使用 -Xlisto 指定生成的报告输出文件。(在 oname 之间必须有一个空格。)使用 -Xlisto name,将会输出到 name 而不是 file.lst

要直接显示到屏幕上,请使用以下选项: -Xlisto /dev/tty

–Xlists

禁止交叉引用中未引用的符号 

可使用 -Xlists 在交叉引用表中禁止 include 文件中已定义但源文件中未引用的任何标识符。

如果使用了子选项 -XlistI,该子选项将不起作用。

缺省情况下,显示 #includeINCLUDE 文件中出现的标识符。

–Xlistvn

设置检查“严格”程度 

n 可以是 1、234。缺省值为 2 (–Xlistv2):

  • –Xlistv1

    仅以摘要形式显示所有名称的交叉检查信息,不带行号。这是检查严格性的最低级别-仅检查语法错误。

  • –Xlistv2

    以摘要和行号显示交叉检查信息。这是检查严格性的缺省级别,包括参数不一致性错误和变量使用错误。

  • –Xlistv3

    以摘要、行号和公共块映射显示交叉检查。这是检查严格性的较高级别,包括由不同子程序公共块中数据类型的错误使用所造成的错误。

  • –Xlistv4

    以摘要、行号、公共块映射和等价块映射显示交叉检查。这是最为严格的检查级别,可以检测出最多的错误。

–Xlistw[nnn]

设置输出行的宽度 

可使用 -Xlistw 设置输出行的宽度。例如,-Xlistw132 将页宽度设置为 132 列。缺省值为 79。

–Xlistwar[nnn]

在报告中禁止警告 nnn

可使用 -Xlistwar 禁止输出报告中的特定警告消息。如果未指定 nnn,则禁止打印所有警告消息。例如,-Xlistwar338 禁止警告消息号 338。要禁止一条以上的警告但并非所有警告,可重复使用该选项。

–XlistX

只显示交叉引用表和错误 

-XlistX 产生交叉引用表和跨例程错误列表,但不产生任何源代码列表。