-qoptfile (@文件)
适用的调用
| 选项 | xlc (编译 C) | xlC (编译 C++) | xlclang（编译 C） | xlclang++（编译 C++） |
|---|---|---|---|---|
| -qoptfile | ✓ | ✓ | ✓ | ✓ |
| -@文件 | ✓ | ✓ |
注: 此表中仅列出典型调用。 对于所有基本调用及其等效特殊调用，您可以参阅 编译器调用的完整列表 。
类别
等效编译指示
无。
用途
指定包含要用于编译的其他命令行选项列表的响应文件。 响应文件通常具有 .rsp 后缀。
语法
缺省值
无。
参数
- filename
- 指定包含其他命令行选项列表的 response 文件的名称。 filename 可以包含相对路径或绝对路径，也可以不包含任何路径。 它是一个纯文本文件，每 行中包含一个或多个 命令行选项。
使用量
响应文件的格式遵循以下规则：
- 使用与命令行相同的语法指定要包含在文件中的选项。 响应文件是一个以空格分隔的选项列表。 以下特殊字符表示空格：
\n、\v和\t。 （所有这些字符都具有相同的效果。） - 一对单引号或双引号之间的字符串作为一个选项传递给编译器。
- 您可以在响应文件中包含注释。 注释行以
#字符开头并继续至行尾。 编译器忽略注释和空行。
处理后，编译器会从命令行中删除 -qoptfile 选项，并在您指定的其他后续选项之前依次插入文件中包含的选项。
-qoptfile 选项在响应文件中也有效。 包含另一个响应文件的文件以深度优先方式处理。 编译器通过检测和忽略响应文件包含中的循环来避免无限循环。
如果在同一命令行上指定了 -qoptfile 和 -qsaveopt，则将原始命令行用于 -qsaveopt。 每个响应文件都包含一个新行，表示每个响应文件的内容。 文件中包含的选项被保存到编译的目标文件中。
预定义的宏
无。
示例 1
下面是一个指定响应文件的示例。
$ cat options.rsp
# To perform optimization at -O3 level, and high-order
# loop analysis and transformations during optimization
-O3 -qhot
# To generate position-independent code
-qpic
$ xlC -qlist -qoptfile=options.rsp -qipa test.c$ xlC -qlist -O3 -qhot -qpic -qipa test.c示例 2
这是指定包含具有循环的 -qoptfile 的 响应 文件的示例。
$ cat options.file1
# To perform optimization at -O3 level, and high-order
# loop analysis and transformations during optimization
-O3 -qhot
# To include the -qoptfile option in the same response file
-qoptfile=options.file1
# To generate position-independent code
-qpic
# To produce a compiler listing file
-qlist
$ xlC -qlist -qoptfile=options.file1 -qipa test.c$ xlC -qlist -O3 -qhot -qpic -qlist -qipa test.c示例 3
这是一个指定 response 文件的示例，该文件包含没有循环的 -qoptfile 。
$ cat options.file1
-O3 -qhot
-qoptfile=options.file2
-qalias=ansi
$ cat options.file2
-qchars=signed
$ xlC -qoptfile=options.file1 test.c$ xlC -O3 -qhot -qalias=ansi -qchars=signed test.c示例 4
以下是在同一命令行上指定 -qsaveopt 和 -qoptfile 的示例。
$ cat options.file3
-O3
-qhot
$ xlC -qsaveopt -qipa -qoptfile=options.file3 test.c -c
$ what test.o
test.o:
opt f xlC -qsaveopt -qipa -qoptfile=options.file3 test.c -c
optfile options.file3 -O3 -qhot