附录 B C 编译器选项参考

本章按字母顺序介绍 C 编译器选项。有关按功能分组的选项，请参见附录 A，按功能分组的编译器选项。例如，表 A–1 列出了所有优化和性能选项。

请注意，缺省情况下，C 编译器识别 1999 ISO/IEC C 标准的某些构造。具体来说，附录 D，支持的 C99 功能 中详细介绍了受支持的功能。如果要用 1990 ISO/IEC C 标准限制编译器，请使用 -xc99=none 命令。

如果要将 K&R C 程序导入 ISO C，请特别注意有关兼容性标志的一节，B.2.63 -X[c|a| t|s]。使用它们可以简化到 ISO C 的转换。另请参阅5.4 内存引用约束的示例中有关转换的介绍。

B.1 选项语法

cc 命令的语法为：

% cc [options] filenames [libraries]...

其中：

• options 表示表 A–15 中介绍的一个或多个选项。

• filenames 表示在生成可执行程序过程中使用的一个或多个文件。

  C 编译器接受包含在由 filenames 指定的文件列表中的 C 源文件和目标文件的列表。除非使用 -o 选项，否则最终可执行代码将位于 a.out 中。在这种情况下，代码位于由 -o 选项指定的文件中。

  使用 C 编译器可编译和链接以下任何组合：

  • C 源文件，带有 .c 后缀

  • 内联模板文件，带有 .il 后缀（仅当使用 .c 文件指定时）

  • C 预处理源文件，带有 .i 后缀

  • 目标代码文件，带有 .o 后缀

  • 汇编程序源文件，带有 .s 后缀

    在链接之后，C 编译器将所链接的文件（当前在可执行代码中）置于一个名称为 a.out 的文件中，或由 -o 选项指定的文件中。当编译器为每个 .i 或 .c 输入文件生成目标代码时，它总是在当前工作目录中创建一个目标 (.o) 文件。

  libraries 表示许多标准库或用户提供库中的任意库，这些库包含函数、宏和常量的定义。

请参见选项 -YP, dir，以更改用于查找库的缺省目录。dir 是以冒号分隔的路径列表。cc 的缺省库搜索顺序为：

/opt/SUNWspro/prod/lib

/usr/ccs/lib

/usr/lib

cc 使用 getopt 来分析命令行选项。这些选项被视为单个字母或后面带一个参数的单个字母。请参见 getopt(3c)。

B.2 cc 选项

本节按字母顺序介绍 cc 选项。手册页 cc (1) 中也提供了这些说明。使用 cc -flags 选项可获得一行有关这些说明的摘要。

注明特定于一个或多个平台的选项可被接受，且不会出现错误，但在其他所有平台上会被忽略。有关用于选项和参数的印刷符号的说明，请参阅印刷约定。

B.2.1 -#

打开详细模式，显示命令选项的展开过程。显示调用的每个组件。

B.2.2 -###

在调用每个组件时显示该组件，但不实际执行它。还显示命令选项扩展的过程。

B.2.3 -Aname[ (tokens)]

将 name 作为谓词与指定的 tokens 关联，如同使用 #assert 预处理指令一样。预断言：

• system(unix)

• machine(sparc) (SPARC)

• machine(i386) (x86)

• cpu(sparc) (SPARC)

• cpu(i386) (x86)

这些预断言在 -Xc 模式下无效。

如果 -A 后面仅跟随一个短横线 (-)，将导致所有预定义宏（除那些以 __ 开头的宏以外）和预定义断言被忽略。

B.2.4 -B[static| dynamic]

指定用于链接的库绑定是 static 类型还是 dynamic 类型，可分别指明库是非共享的还是共享的。

如果给定 -lx 选项，则 –Bdynamic 使链接编辑器查找名称为 libx.so 的文件，然后查找名称为 libx.a 的文件。

–Bstatic 使链接编辑器仅查找名称为 libx.a 的文件。此选项可作为一个切换开关在命令行中多次指定。此选项及其参数将传递给 ld(1)。

在 Solaris 64 位编译环境中，许多系统库（例如 libc）都只能作为动态库使用。因此，请勿将 -Bstatic 用作命令行的最后一个切换。

此选项及其参数传递给链接程序。

B.2.5 -C

防止 C 预处理程序删除注释，位于预处理指令行中的注释除外。

B.2.6 -c

指示 C 编译器用 ld(1) 抑制链接并为每个源文件生成一个 .o 文件。您可使用 -o 选项显式指定单个目标文件。当编译器为每个 .i 或 .c 输入文件生成目标代码时，它总是在当前工作目录中创建一个目标 (.o) 文件。如果抑制链接步骤，将会同时抑制删除目标文件。

B.2.7 -Dname[( arg[,arg])][= expansion]

使用可选参数定义宏，如同使用 #define 预处理指令定义宏一样。如果未指定 =expansion，则编译器假定为 1。

预定义（在 -Xc 模式下无效）：

• sun

• unix

• sparc (SPARC)

• i386 (x86)

以下预定义在所有模式下均有效。

• __BUILTIN_VA_ARG_INCR

• __SUNPRO_C=0x590

• __SVR4 (SPARC)

• __SunOS（Solaris 操作系统）

• __SunOS_n_n（Solaris 操作系统）

• __amd64（启用了 -m64 的 x86）

• __gnu__linux (linux)

• __i386 (x86)

• __linux (linux)

• __linux__ (linux)

• __sparc (SPARC)

• __sparcv9 (-xarch=v9, v9a, v9b)

• __sun（Solaris 操作系统）

• __unix

• __SunOS_n_n（Solaris 操作系统）（例如：__SunOS_5_9）

以下内容仅在 -Xa 和 -Xt 模式下预定义：

• __RESTRICT

编译器还预定义类似于对象的宏 __PRAGMA_REDEFINE_EXTNAME，以指示该 pragma 将被识别。

B.2.8 -d[y|n]

-dy 指定动态链接，这是链接编辑器中的缺省链接。

-dn 指定链接编辑器中的静态链接。

此选项及其参数将传递给 ld(1)。

如果将此选项与动态库结合使用，将导致致命错误。大多数系统库仅作为动态库可用。

B.2.9 -dalign

(SPARC) 已废弃。您不该使用此选项。应改用 -xmemalign=8s。有关更多信息，请参见B.2.111 -xmemalign=ab。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

B.2.10 -E

仅通过预处理程序运行源文件，并将输出发送给 stdout。预处理程序直接构建到编译器中，但 -Xs 模式除外，因为该模式会调用 /usr/ccs/lib/cpp。包含预处理程序行号信息。另请参见 – P 选项。

B.2.11 -errfmt[=[ no%]error]

如果要将字符串 "error:" 作为前缀添加到错误消息开头以将错误消息与警告消息相区分，可使用此选项。此前缀也可附加到通过 -errwarn 转换成错误的警告。

如果不指定此选项，则编译器将其设置为 -errfmt=no%error。如果您指定 -errfmt，但不提供值，则编译器将其设置为 -errfmt=error。

B.2.12 -erroff[= t]

此命令抑制 C 编译器警告消息，但对错误消息没有影响。此选项适用于所有警告消息，无论这些警告消息是否已被 -errwarn 指定为导致非零退出状态。

t 是一个逗号分隔列表，它包含以下项中的一项或多项：tag、no%tag、%all、%none。顺序是很重要的；例如 %all,no%tag 抑制除 tag 以外的所有警告消息。下表列出了 -erroff 值：

缺省值为 -erroff=%none。指定 -erroff 与指定 -erroff=%all 等效。

-erroff 选项只能抑制来自 C 编译器前端并在使用 -errtags 选项时显示标记的警告消息。您可以更好地控制错误消息抑制。请参见2.8.6 error_messages。

B.2.13 -errshort[= i]

使用此选项可在编译器发现类型不匹配时控制所生成错误消息的详细程度。当编译器发现涉及到大聚集的类型不匹配时，此选项特别有用。

i 可以是以下各项之一：

如果不指定 -errshort，编译器会将该选项设置为 -errshort=full。如果指定 -errshort 但不提供值，编译器会将该选项设置为 -errshort=tags。

此选项不会累积，它接受在命令行指定的最后一个值。

B.2.14 -errtags[= a]

为 C 编译器前端可用 -erroff 选项抑制或用 -errwarn 选项生成致命错误的每条警告消息显示消息标记。来自 C 编译器驱动程序以及 C 编译系统其他组件的消息不带错误标记，使用 -errof 选项并不能抑制这些消息，而使用 -errwarn 选项也不会产生致命错误。

a 可以是 yes 或 no。缺省值为 -errtags=no。指定 -errtags 与指定 -errtags=yes 等效。

B.2.15 -errwarn[= t]

使用 -errwarn 选项会使 C 编译器以给定警告消息的故障状态退出。

t 是一个逗号分隔列表，它包含以下项中的一项或多项：tag、no%tag、%all、%none。顺序很重要，例如如果出现除 tag 之外的任何警告，%all,no%tag 会使 cc 以致命状态退出。

由于编译器错误检查的改善和功能的增加，C 编译器生成的警告消息也会因发行版本而异。使用 -errwarn=%all 进行编译而不会产生错误的代码，在编译器下一个发行版本中编译时也可能出现错误。

只有来自 C 编译器前端在使用 -errtags 选项时会显示标记的警告消息可以使用 -errwarn 选项进行指定，从而使 C 编译器以失败状态退出。

下表详细列出了 -errwarn 值：

缺省值为 -errwarn=%none。如果单独指定 -errwarn，它与 -errwarn=%all 等效。

B.2.16 -fast

此选项是一个宏，可将其有效用作为尽量提高运行时性能而调整可执行程序的起点。-fast 是一个宏，可随编译器发行版本的升级而更改，并能扩展为目标平台特定的选项。可使用 -# 选项或 -xdryrun 检查 -fast 的扩展选项，并将 -fast 的相应选项结合到正在进行的可执行文件调节过程中。

-fast 的扩展选项现在包括新的 -xlibmopt 选项。该选项使编译器可以使用优化的数学例程库。有关更多信息，请参见B.2.99 -xlibmopt。

-fast 选项会影响 errno 的值。有关更多信息，请参见2.10 errno 的值。

用 -fast 编译的模块必须也用 -fast 进行链接。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见A.1.2 编译时选项和链接时选项。

–fast 选项不适于计划在编译机器之外的其他目标机器上运行的程序。在这种情况下，请在 -fast 后附带相应的 -xtarget 选项。例如：

cc -fast -xtarget=ultra ...

对于依赖于 SUID 指定的异常处理的 C 模块，请在 -fast 后附带 -xnolibmil：

% cc -fast -xnolibmil

使用 -xlibmil 时，通过设置 errno 或调用 matherr(3m) 无法标记异常。

–fast 选项不适于要求与 IEEE 754 标准严格一致的程序。

下表列出了 -fast 在各平台中选择的选项集。

有些优化对程序行为进行特定假定。如果程序不符合这些假定，应用程序将会崩溃或产生错误结果。请参阅各个选项的描述，以确定您的程序是否适合用 -fast 编译。

由这些选项执行的优化可能会改变由 ISO C 和 IEEE 标准定义的程序的行为。有关详细信息，请参见特定选项的描述。

–fast 的作用与命令行上的宏扩展相同。因此，您可以通过在 -fast 后附带预期的优化级别或代码生成选项来覆盖优化级别和代码生成选项。使用 -fast -xO4 对编译类似于使用 -xO2 -xO4 对编译。后者优先。

请勿对依赖于 IEEE 标准异常处理的程序使用此选项；否则会产生不同的数值结果、程序提前终止或意外的 SIGFPE 信号。

B.2.17 -fd

报告 K&R 样式的函数定义和声明。

B.2.18 -features=[[no%] extinl|%none]

缺省情况下，编译器对外部内联函数的处理符合 ISO/IEC 9899:1999 C 标准指定的行为。使用 -features=no%extinl 编译新代码以获取对外部内联函数的处理，该处理和版本 5.5（或早期版本）的 C 和 C++ 编译器提供的处理相同。

旧的 C 和 C++ 对象（使用本发行版之前的 Sun 编译器创建的对象）可以与新的 C 和 C++ 对象链接，而不会更改旧对象的行为。要获得标准的符合规范的行为，您必须使用当前编译器重新编译旧代码。

如果不为 -features 指定设置，编译器将把它设置为 -features=extinl。

B.2.19 -flags

打印每个可用编译器选项的简短概要。

B.2.20 -flteval[={ any|2}]

(x86) 使用此选项可以控制浮点表达式的求值方式。

如果未指定 -flteval，编译器会将其设置为 -flteval=any。如果指定了 -flteval 但未提供值，编译器会将其设置为 -flteval=2。

您不能将以下选项与 -flteval=2 一起指定：

• -fprecision

• -nofstore

• -xarch=amd64

• -xarch=sse2

另请参见D.1.1 浮点计算器的精度。

B.2.21 -fma[={none| fused}]

(SPARC) 允许自动生成浮点乘加指令。-fma=none 禁止生成这些指令。利用 -fma=fused，编译器可尝试寻找机会，通过使用浮点乘加指令来提高代码性能。

缺省值为 -fma=none。

使编译器生成乘加指令的最低要求是：-xarch=sparcfmaf，优化级别至少为 -xO2。如果生成了乘加指令，则编译器将标记二进制程序，从而避免程序在不支持这些指令的平台上执行。

B.2.22 -fnonstd

(SPARC) 此选项是用于 -fns 和 -ftrap=common 的宏。

B.2.23 -fns[={no|yes}]

• (SPARC) 打开 SPARC 非标准浮点模式。

  缺省值为 -fns=no，SPARC 标准浮点模式。-fns 与 -fns=yes 相同。

  可以选择使用 =yes 或 =no，此方法使您可以切换包含 -fns 的其他某个宏标志（如 -fast）后面的 -fns 标志。

  在一些 SPARC 系统上，使用非标准浮点模式会禁用“渐进下溢”，导致将微小的结果刷新为零，而不是产生非正规数。它还导致次正规操作数被替换为零而无提示。在那些不支持硬件中的渐进下溢和次正规数的 SPARC 系统上，使用此选项将显著提高某些程序的性能。

  在启用了非标准模式的情况下，浮点运算可能会产生不符合 IEEE 754 标准要求的结果。有关详细信息，请参见《数值计算指南》。

  此选项仅对 SPARC 系统且仅在编译主程序时使用才有效。在 x86 系统上，忽略此选项。

• (x86) 选择 SSE 刷新为零模式以及（如果可用）非正规数为零模式。

  此选项导致将次正规结果刷新为零。如果可用的话，此选项还导致将次正规操作数视为零。

  此选项不会影响利用 SSE 或 SSE2 指令集的传统 x86 浮点运算。

B.2.24 -fprecision=p

(x86) -fprecision={single, double, extended}

将浮点控制字中的舍入精度模式位分别初始化为 single（24 位）、double（53 位）或 extended（64 位）。缺省的浮点舍入精度模式为 extended。

注意，在 x86 中，浮点舍入精度模式的设置只影响精度，不影响指数、范围。

B.2.25 -fround=r

设置程序初始化期间在运行时建立的 IEEE 754 舍入模式。

r 必须是以下值之一：nearest、 tozero、negative、positive。

缺省值为 -fround=nearest。

含义与 ieee_flags 子例程的含义相同。

如果 r 为 tozero、negative 或 positive，此标志将在程序开始执行时分别将舍入方向模式设置为舍入到零、舍入到负无穷大或舍入到正无穷大。当 r 为 nearest 或未使用 -fround 标志时，舍入方向模式将保留其初始值不变（缺省为舍入到最接近的值）。

只有编译主程序时该选项才有效。

B.2.26 -fsimple[= n]

允许优化器进行有关浮点运算的简化假定。

编译器缺省采用 -fsimple=0。指定 -fsimple 与指定 -fsimple=1 等效。

如果存在 n，它必须是 0、1 或 2。

即使 -fsimple=2，也不允许优化器在不产生任何内容的程序中引入浮点异常。

有关优化对精度的影响的详细说明，请参见由 Rajat Garg 和 Ilya Sharapov 合著的《Techniques for Optimizing Applications:High Performance Computing》。

B.2.27 -fsingle

（仅限 -Xt 和 -Xs 模式）使编译器按单精度而非双精度对 float 表达式求值。由于已按单精度对 float 表达式进行求值，因此如果在 -Xa 或 -Xc 模式下使用编译器，此选项将无效。

B.2.28 -fstore

(x86) 将表达式或函数赋值给一个变量时或将表达式强制转换为短浮点类型时，该命令可使编译器将浮点表达式或函数的值转换为赋值语句左侧的类型，而不是在寄存器中保留值。由于舍入和截尾，结果可能会与使用寄存器值生成的结果不同。这是缺省模式。

要关闭此选项，请使用 -nofstore 选项。

B.2.29 -ftrap=t[ ,t...]

设置启动时生效的 IEEE 捕获模式，但不安装 SIGFPE 处理程序。可以使用 ieee_handler(3M) 或 fex_set_handling(3M) 启用陷阱并同时安装 SIGFPE 处理程序。如果指定多个值，则按从左到右顺序处理列表。

t 可以是下列值之一。

注意，选项的 [no%] 形式只用于修改 %all 和 common 值的含义，且必须与其中的一个值一起使用，如以下示例所示。选项自身的 [no%] 形式不会显式导致禁用特定的陷阱。

如果不指定 –ftrap，则编译器假定 –ftrap=%none。

示例：–ftrap=%all,no%inexact 意味着设置所有陷阱，但 inexact 除外。

如果先使用 –ftrap=t 编译一个例程，就还要使用相同的 -ftrap=t 选项来编译程序的所有例程；否则就会获得意外的结果。

使用 -ftrap=inexact 陷阱时务必谨慎。只要浮点值不能精确表示，使用 –ftrap=inexact 便会产生陷阱。例如，以下语句就会产生这种情况：

x = 1.0 / 3.0;

只有编译主程序时该选项才有效。请小心使用该选项。如果希望启用 IEEE 陷阱，请使用 –ftrap=common。

B.2.30 -G

生成共享对象而非动态链接的可执行文件。此选项将传递给 ld(1)，并且无法与 -dn 选项一起使用。

使用 -G 选项时，编译器不将任何缺省 -l 选项传递到 ld 选项。如果您要使共享库具有对另一共享库的依赖性，就必须在命令行上传递必需的 -l 选项。

如果通过指定 -G 以及其他必须在编译时和链接时指定的编译器选项来创建共享对象，请确保在与生成的共享对象链接时也指定这些选项。

创建共享对象时，用 -xarch=v9 编译的所有目标文件还必须用显式 -xcode 值（如B.2.80 -xcode[= v]中所记录）进行编译。

B.2.31 -g

为使用 dbx(1) 和性能分析器 analyzer(1) 进行调试生成附加符号表信息。

如果指定 -g，并且优化级别为 -xO3 或更低，则编译器提供几乎进行全面优化的最佳效果符号信息。尾部调用优化和后端内联被禁用。

如果指定 -g，并且优化级别为 -xO4，则编译器提供进行全面优化的最佳效果符号信息。

使用 -g 选项进行编译，以使用性能分析器的全部功能。虽然某些性能分析功能不需要使用 -g，但必须使用 -g 进行编译，以便查看注释的源代码、部分函数级别信息以及编译器注释消息。有关更多信息，请参见 analyzer(1) 手册页和《性能分析器》手册。

使用 -g 生成的注释消息描述编译器在编译程序时进行的优化和变换。使用 er_src(1) 命令来显示与源代码交叉的消息。

在以前的发行版中，此选项强制编译器在缺省情况下使用增量链接程序 (ild)，而不使用用于编译器的仅链接调用的链接程序 (ld)。也就是说，使用 -g 时，只要使用编译器来链接目标文件，编译器的缺省行为就是自动调用 ild 而不是 ld，除非您在命令行上指定了 -G 或源文件。现在已不再是这种情况。增量链接程序不再可用。

有关调试的更多信息，请参见《使用 dbx 调试程序》手册。

B.2.32 -H

打印到标准错误，每行一个错误，包含当前编译期间每个文件的路径名。这样打印的目的是显示包含在其他文件中的文件。

此处，程序 sample.c 包含文件 stdio.h 和 math.h；math.h 包含文件 floatingpoint.h，该文件本身还包含使用 sys/ieeefp.h 的函数：

% cc -H sample.c
    /usr/include/stdio.h
    /usr/include/math.h
        /usr/include/floatingpoint.h
            /usr/include/sys/ieeefp.h

B.2.33 -h name

为动态共享库分配一个名称，从而可以获得一个库的不同版本。通常，-h 后面的 name 应与 -o 选项后指定的文件名相同。-h 和 name 之间的空格是可选的。

链接程序会为该库分配指定的 name，并在库文件中将该名称记录为库的内在名称。如果 -hname 选项不存在，则库文件中不记录任何内在名称。

当运行时链接程序将库装入可执行文件时，它将内在名称从库文件复制到可执行文件和一组所需共享库文件中。每个可执行文件都有这样的列表。如果没有共享库的内在名称，链接程序就复制共享库文件的路径。

B.2.34 -I[-| dir]

-I dir 将 dir 添加到在其中搜索 #include 文件（/usr/include 前是相对文件名）的目录列表中，也就是说，这些目录路径不以 /（斜线）开头。

以指定的顺序搜索多个 -I 选项的目录。

有关编译器搜索模式的更多信息，请参见2.14.1 使用 -I- 选项更改搜索算法。

B.2.35 -i

将选项传递给链接程序，以忽略任何 LD_LIBRARY_PATH 或 LD_LIBRARY_PATH_64 设置。

B.2.36 -KPIC

(SPARC) 已废弃。您不该使用此选项。应改用 -xcode=pic32。

有关更多信息，请参见B.2.80 -xcode[= v]。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

(x86) -KPIC 与 -Kpic 相同。

B.2.37 -Kpic

(SPARC) 已废弃。您不该使用此选项。应改用 -xcode=pic13。有关更多信息，请参见B.2.80 -xcode[= v]。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

(x86) 生成要在共享库中使用的与位置无关的代码。允许最多引用 2**11 个唯一外部符号。

B.2.38 -keeptmp

保留编译期间创建的临时文件，而不自动将其删除。

B.2.39 -Ldir

将 dir 添加到通过 ld(1) 在其中搜索库的目录列表中。此选项及其参数将传递给 ld(1)。

任何时候都不要将编译器安装区域 /usr/include、/lib 或 /usr/lib 指定为搜索目录。

B.2.40 -lname

与目标库 libname .so 或 libname.a 链接。库在命令行中的顺序很重要，因为符号是从左向右进行解析。

此选项必须位于 sourcefile 参数之后。

B.2.41 -m32|-m64

为已编译的二进制对象指定内存模型。

使用 -m32 可创建 32 位可执行文件和共享库。使用 -m64 可创建 64 位可执行文件和共享库。

在所有 Solaris 平台和不支持 64 位的 Linux 平台上，ILP32 内存模型（32 位 int、long 和 pointer 数据类型）是缺省值。在支持 64 位的 Linux 平台上，LP64 内存模型（64 位 long 和 pointer 数据类型）是缺省值。-m64 仅允许在支持 LP64 模型的平台上使用。

使用 -m32 编译的目标文件或库不能与使用 -m64 编译的目标文件或库链接。

当使用 -m64 编译具有大量静态数据的应用程序时，可能还需要使用 -xmodel=medium。请注意，某些 Linux 平台不支持中等模型。

请注意，在以前的编译器发行版中，内存模型 ILP32 或 LP64 是通过 -xarch 选择指令集来隐式指定的。从 Sun Studio 12 编译器开始，就不再是这样了。在大多数平台上，只需在命令行上添加 -m64，就可以创建 64 位对象。

在 Solaris 上，-m32 是缺省值。在支持 64 位程序的 Linux 系统上，-m64 -xarch=sse2 是缺省值。

另请参见 -xarch。

B.2.42 -mc

从目标文件的 .comment 部分中删除重复字符串。使用 -mc 标志时，会调用 mcs -c。

B.2.43 -misalign

(SPARC) 已废弃。您不该使用此选项。应改用 -xmemalign=1i 选项。有关更多信息，请参见B.2.111 -xmemalign=ab。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

B.2.44 -misalign2

(SPARC) 已废弃。您不该使用此选项。应改用 -xmemalign=2i 选项。有关更多信息，请参见B.2.111 -xmemalign=ab。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

B.2.45 -mr[, string]

-mr 可从 .comment 部分中删除所有字符串。使用此标志时，会调用 mcs -d -a。

-mr,string 可从 .comment 部分中删除所有字符串，并在目标文件的该部分中插入 string。如果 string 包含嵌入空白，则必须将其括入引号。空 string 将导致 .comment 部分为空。此选项将作为 -d -astring 传递给 mcs。

B.2.46 -mt

编译和链接多线程代码。

该选项将 -D_REENTRANT 传递给预处理程序，并将 -lthread 以正确的顺序传递给 ld。

如果应用程序或库是多线程的，则必须使用 -mt 选项。

为了确保正确的库链接顺序，必须使用该选项而不是 -lthread 来与 libthread 链接。

如果正在使用 POSIX 线程，则必须使用选项 -mt -lpthread 进行链接。由于在多线程应用程序环境中 libC 和 libCrun 需要使用 libthread，因此必须使用 -mt 选项。

如果在不同的步骤中进行编译和链接，并且使用 -mt 进行编译，则可能出现意外结果。如果使用 -mt 编译一个转换单元，请使用 -mt 编译程序的所有单元。

另请参见B.2.113 -xnolib。

B.2.47 -native

此选项与 -xtarget=native 意义相同。

B.2.48 -nofstore

(x86) 将表达式或函数赋值给一个变量时或将表达式强制转换为短浮点类型时，该命令不将浮点表达式或函数的值转换为赋值语句左侧的类型，而在寄存器中保留该值。另请参见B.2.28 -fstore。

B.2.49 -O

使用缺省优化级别 -xO3。-O 宏现在扩展为 -xO3 而非 -xO2。

这种特殊变化会提高运行时性能。但是，对于依赖于被自动视为 volatile 的所有变量的程序，-x03 可能不适用。可能做出此假定的典型程序包括设备驱动程序，以及实现其自己的同步基元的较旧的多线程应用程序。解决方法是用 -xO2 而不是 -O 进行编译。

B.2.50 -o filename

将输出文件命名为 filename（与缺省文件名 a.out 相对）。filename 的名称不能与sourcefile 相同，因为 cc 不覆盖源文件。 此选项及其参数将传递给 ld(1)。

B.2.51 -P

只通过 C 预处理程序运行源文件。然后将输出放在带有 .i 后缀的文件中。与 -E 不同，此选项不在输出中包括预处理程序类型的行号信息。另请参见 -E 选项。

B.2.52 -p

已废弃，请参见B.2.127 -xpg。

B.2.53 -Q[y|n]

向输出文件发出或不发出标识信息。-Qy 是缺省值。

如果使用 -Qy，则将关于每个调用的编译工具的标识信息添加到输出文件的 .comment 部分，使用 mcs 可访问这部分文件。此选项对软件管理十分有用。

-Qn 可抑制此信息。

B.2.54 -qp

与 -p 相同。

B.2.55 -Rdir[ :dir]

将用来指定库搜索目录的、冒号分隔的目录列表传递给运行时链接程序。如果此选项存在且非空，则它记录在输出目标文件中并传递给运行时链接程序。

如果同时指定了 LD_RUN_PATH 和 -R 选项，则 -R 选项优先。

B.2.56 -S

指示 cc 生成汇编源文件，而不汇编程序。

B.2.57 -s

从输出目标文件中删除所有符号调试信息。此选项不能与 -g 一同指定。

传递给 ld(1)。

B.2.58 -Uname

取消定义预处理程序符号 name。此选项可删除由 -D 在命令行上创建的预处理程序符号 name 的任何初始定义，包括那些由命令行驱动程序放置的定义。

-U 对源文件中的预处理程序指令没有任何影响。可以在命令行上指定多个 -U 选项。

如果在命令行中为 -D 和 -U 指定了相同的 name，则取消定义 name，而无论这些选项出现的顺序如何。在以下示例中，-U 取消定义 __sun：

cc -U__sun text.c

由于已取消定义 __sun，因此在 test.c 中采用以下形式的预处理程序语句将不会生效。

#ifdef(__sun)

有关预定义符号的列表，请参见B.2.7 -Dname[( arg[,arg])][= expansion]。

B.2.59 -V

指示 cc 在编译器执行时打印每个组件的名称和版本 ID。

B.2.60 -v

指示编译器执行更严格的语义检查并启用其他与 lint 类似的检查。例如，如下所示代码：

#include <stdio.h>
main(void)
{
     printf("Hello World.\n");
}

编译和执行时不会出现问题。如果使用 -v，该代码仍可编译；但是，编译器会显示以下警告：

"hello.c", line 5: warning: function has no return statement:
 main

-v 不能给出 lint(1) 给出的所有警告。尝试通过 lint 运行以上示例。

B.2.61 -Wc ,arg

将参数 arg 传递给指定的组件 c。有关组件的列表，请参见表 1–1。

每个参数与前一个参数之间仅以逗号分隔。所有 -W 参数均在常规命令行参数之后进行传递。在紧靠逗号之前使用转义符 \（反斜杠）可将逗号作为参数的一部分。所有 -W 参数均在常规命令行参数之后进行传递。

例如， -Wa,-o,objfile 按顺序将 -o 和 objfile 传递给汇编程序。此外，-Wl,-I,name 将导致链接阶段覆盖动态链接程序的缺省名称 /usr/lib/ld.so.1。

参数传递到工具的顺序可能会因其他指定的命令行选项而更改。

c 可以是以下项之一：

B.2.62 -w

抑制编译器警告消息。

此选项会覆盖 error_messages pragma。

B.2.63 -X[c|a| t|s]

-X（注意是大写的 X）选项指定对 ISO C 标准不同程度的遵从性。-xc99 的值影响 -X 选项所应用的 ISO C 标准的版本。-xc99 选项的缺省值为支持 1999 ISO/IEC C 标准的 -xc99=all。-xc99=none 支持 1990 ISO/IEC C 标准。有关对 1999 ISO/IEC 支持功能的讨论，请参见表 C–6。有关 ISO/IEC C 与 K&R C 的不同点的讨论，请参见G.2 libfast.a 库。

缺省模式是 -Xa。

-Xc

（c =一致性）对使用非 ISO C 构造的程序发出错误和警告。此选项与 ISO C 严格一致，没有 K&R C 兼容性扩展。如果使用 -Xc 选项，预定义的宏 __STDC__ 的值为 1。

-Xa

这是缺省编译器模式。ISO C 以及 K&R C 兼容性扩展，具有 ISO C 要求的语义更改。如果 K&R C 和 ISO C 为同一构造指定不同语义，则编译器使用 ISO C 解释。如果 -Xa 选项与 -xtransition 选项配合使用，则编译器发出关于不同语义的警告。如果使用 -Xa 选项，预定义的宏 __STDC__ 的值为 -0。

-Xt

（t = 过渡）此选项使用 ISO C 以及 K&R C 兼容性扩展，不进行 ISO C 要求的语义更改。如果 K&R C 和 ISO C 为同一构造指定不同语义，则编译器使用 K&R C 解释。如果将 -Xt 选项与 -xtransition 选项配合使用，则编译器发出关于不同语义的警告。如果使用 -Xt 选项，预定义的宏 __STDC__ 的值为 0。

-Xs

(s = K&R C) 试图对 ISO C 和 K&R C 产生不同行为的所有语言构造发出警告。编译器语言包括与 K&R C 兼容的所有功能。此选项调用 cpp 以进行预处理。__STDC__ 在此模式下未定义。

B.2.64 -x386

(x86) 已废弃。您不该使用此选项。应改用 -xchip=generic。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

B.2.65 -x486

(x86) 已废弃。您不该使用此选项。应改用 -xchip=generic。有关废弃选项的完整列表，请参见A.1.15 废弃的选项。

B.2.66 -xa

已废弃。不使用此选项。改用 -xprofile=tcov。有关废弃选项和标志的完整列表，请参见A.1.15 废弃的选项。

B.2.67 -xalias_level[= l]

编译器使用 -xalias_level 选项确定为了使用基于类型的别名分析执行优化可以进行何种假设。此选项使指定的别名级别对正在编译的转换单元生效。

如果不指定 -xalias_level 命令，编译器将假定 -xalias_level=any。如果指定不带值的 -xalias_level，则缺省值为 -xalias_level=layout。

-xalias_level 选项要求的优化级别为 -xO3 或更高。如果优化级别设置较低，则发出警告并忽略 -xalias_level 选项。

切记，如果使用 -xalias_level 选项，但无法坚持为任何别名级别描述的关于别名的所有假定和约束，则程序的行为未定义。

将 l 替换为下表中的某一术语。

B.2.68 -xarch=isa

指定指令集体系结构 (instruction set architecture, ISA)。如果在进行优化时使用该选项，那么在指定体系结构上适当选择就可以提供高性能的可执行文件。如果选择不当，则会导致二进制程序在预定的目标平台上无法执行。

使用 -m64 或 -m32 选项可分别指定预定的内存模型：LP64（64 位）或 ILP32（32 位）。-xarch 选项不再指明内存模型，但为了与以前发行版兼容的情况除外，如下所示。

虽然 -xarch 可单独使用，但它是 -xtarget 选项扩展的一部分，并可能会用于覆盖由特定的 -xtarget 选项设置的 -xarch 值。例如：

% cc -xtarget=ultra2 -xarch=v8plusb ...

会覆盖 -xtarget=ultra2 设置的 -xarch=v8。

B.2.68.1 用于 SPARC 的 -xarch 标志

下表详细说明了使用指定的 -xarch 选项编译后由各种 SPARC 处理器执行的可执行程序的性能。此表的目的在于帮助您识别适合您的可执行程序在特定目标机器上运行的最佳 -xarch 选项。首先识别您关心的机器的范围，然后考虑维护多个二进制程序的成本与在较新的机器上获得最高性能的好处。

• N 反映标称性能。程序执行，并充分利用处理器的指令集。

• S 反映满意性能。程序执行，但并不利用所有可用的处理器指令。

• PD 反映性能降低。程序执行，但根据使用的指令可能会导致性能轻微或显著下降。当内核对处理器未实现的指令进行仿真时，出现性能下降。

• NE 表示不可执行。程序因内核不对处理器未实现的指令进行仿真而不可执行。

如果要使用 v8plus 或 v8plusa 指令集编译可执行文件，请考虑改用 v9 或 v9a 进行编译。提供了 v8plus 和 v8plusa 选项，因此程序可在支持 64 位程序的 Solaris 8 软件可用之前利用一些 SPARC V9 和 UltraSPARC 功能。使用 v8plus 或 v8plusa 选项编译的程序不可移植到 SPARC V8 或更旧的机器上。可以分别使用 v9 或 v9a 重新编译此类程序，以充分利用 SPARC V9 和 UltraSPARC 的所有功能。可通过 Sun 代表获得《The V8+ Technical Specification》白皮书，文件号码为 8027447-10，此书解释了 v8plus 和 v8plusa 的限制。

• SPARC 指令集体系结构 V8 和 V8a 均是二进制兼容的。

• 由 v8plus 和 v8plusa 编译的二进制目标文件 (.o) 可以进行链接并可一起执行，但只能在与 SPARC V8plusa 兼容的平台上运行。

• 由 v8plus、v8plusa 和 v8plusb 编译的二进制目标文件 (.o) 可以进行链接并可一起执行，但只能在与 SPARC V8plusb 兼容的平台上运行。

• -xarch 值 v9、v9a 和 v9b 只能在 UltraSPARC 64 位 Solaris 操作系统中使用。

• 使用 v9 和 v9a 编译的二进制目标文件 (.o) 可以进行链接并可一起执行，但是只能在与 SPARC V9a 兼容的平台上运行。

• 使用 v9、v9a 和 v9b 编译的二进制目标文件 (.o) 可以进行链接并可一起执行，但是只能在与 SPARC V9b 兼容的平台上运行。

对于任何特定选择，生成的可执行文件在早期体系结构中运行时都会慢得多。此外，虽然在多数指令集体系结构中都可以使用四精度（REAL*16 和 long double）浮点指令，但编译器不在它生成的代码中使用这些指令。

下表提供了 SPARC 平台上每个 -xarch 关键字的详细信息。

B.2.68.2 用于 x86 的 -xarch 标志

下表列出了 x86 体系结构上的 -xarch 标志。

x86 特别注意事项

下面列出了针对 x86 Solaris 平台进行编译时需注意的一些重要问题。

传统的 Sun 样式的并行化 pragma 在 x86 上不可用。应改用 OpenMP。有关将传统并行化指令转换为 OpenMP 的信息，请参见《Sun Studio 12: OpenMP API User’s Guide》。

使用设置为 sse、sse2、sse2a 或 sse3 的 -xarch 编译的程序只能在提供这些扩展和功能的平台上运行。

从 Solaris 9 4/04 开始的 OS 发行版在 Pentium 4 兼容的平台上支持 SSE/SSE2。早期版本的 Solaris 操作系统不支持 SSE/SSE2。如果正在运行的 Solaris OS 不支持 -xarch 选择的指令集，则编译器将无法为该指令集生成或链接代码。

如果在单独的步骤中编译和链接，请始终使用编译器以及相同的 -xarch 设置进行链接，以确保链接正确的启动例程。

x86 上的数值结果可能与 SPARC 上的结果不同，这是由 x86 80 位浮点寄存器造成的。要最大限度地减少这些差异，请使用 -fstore 选项，或者使用 -xarch=sse2 进行编译（如果硬件支持 SSE2 的话）。

Solaris 和 Linux 之间的数值结果也可能不同，这是因为它们的内在数学库（例如，sin(x)）不同。

二进制兼容性验证

从 Sun Studio 11 和 Solaris 10 OS 开始，会对使用这些专用的 -xarch 硬件标志编译和生成的程序二进制文件进行验证，看它们是否在适当的平台上运行。

在 Solaris 10 之前的系统中，不执行任何验证，用户负责确保使用这些标志生成的对象部署在合适的硬件上。

如果在没有相应功能或指令集扩展的平台上运行使用这些 -xarch 选项编译的程序，则可能会导致段故障或不正确的结果，并且不显示任何显式警告消息。

此警告还适用于使用利用了 SSE、SSE2、SSE2a 和 SSE3 指令及扩展的 .il 内联汇编语言函数或 __asm() 汇编程序代码的程序。

B.2.68.3 SPARC 缺省设置

现在，C 编译器为其生成代码的缺省体系结构是 v8plus (UltraSPARC)。以后的发行版将取消对 v7 的支持。

新的缺省设置几乎可为当前使用的所有计算机都产生更高的运行时性能。但是，在缺省情况下，设计用于在 UltraSPARC 之前的计算机上进行部署的应用程序将不再在那些计算机上执行。使用 -xarch=v8 编译可以确保这些应用程序在那些计算机上执行。

如果要在 v8 系统上部署，则必须在每个编译器命令行以及任何链接时命令中显式指定选项 -xarch=v8。提供的系统库将在 v8 体系结构上运行。

如果要在 v7 系统上部署，则必须在每个编译器命令行以及任何链接时命令上显式指定选项 -xarch=v7。提供的系统库将使用 v8 指令集。对于本发行版，唯一支持 v7 的操作系统是 Solaris 8 软件。遇到 v8 指令时，Solaris 8 操作系统会在软件中解释指令。程序会运行，但性能将下降。

B.2.68.4 x86 缺省设置

对于 x86，-xarch 缺省值为 generic。请注意，x86 上的 -fast 扩展为 -xarch=native。该选项将编译器生成的代码限制为特定指令集体系结构的指令。该选项不保证使用任何目标特定的指令。不过，使用该选项会影响二进制程序的可移植性。

如果在不同的步骤中编译和链接，请确保在两个步骤中为 -xarch 指定了相同的值。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

B.2.69 -xautopar

该选项不接受 OpenMP 并行化指令。Sun 特定的 MP pragma 已过时，不再受支持。有关标准的指令的迁移信息，请参见《Sun Studio 12: OpenMP API User’s Guide》。

(SPARC) 为多个处理程序打开自动并行化。执行依赖性分析（分析循环以了解迭代间数据依赖性）和循环重构。如果优化级别不是 -xO3 或更高级别，则将优化级别提高到 -xO3 并发出警告。

如果要进行自己的线程管理，请勿使用 -xautopar。

为了使执行速度更快，该选项要求使用多处理器系统。在单处理器系统中，生成的二进制文件的运行速度通常较慢。

要在多线程环境中运行已并行化的程序，必须在执行之前设置 OMP_NUM_THREADS 环境变量。有关更多信息，请参见《Sun Studio 12: OpenMP API User’s Guide》。

如果使用 -xautopar，而且在同一步骤中进行编译和链接，则链接将自动包括微任务化库和线程安全的 C 运行时库。如果使用 -xautopar，而且在不同的步骤中进行编译和链接，则还必须使用 -xautopar 进行链接。有关在编译和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

B.2.70 -xbinopt={prepare| off}

(SPARC) 指示编译器为稍后进行的优化、转换和分析准备二进制文件，请参见 binopt(1)。此选项可用于生成可执行文件或共享对象。此选项必须与优化级别 -xO1 或更高级别结合使用才能生效。使用此选项生成二进制文件时，文件会适当增大。

如果在不同的步骤中编译，则 -xbinopt 必须同时出现在编译和链接步骤中：

example% cc -c -xO1 -xbinopt=prepare a.c b.c
example% cc -o myprog -xbinopt=prepare a.o

如果有些源代码不可用于编译，仍可使用此选项来编译其余代码。然后，应将其用于可创建最终库的链接步骤中。在此情况下，只有用此选项编译的代码才能进行优化、转换或分析。

使用 -xbinopt=prepare 和 -g 编译会将调试信息包括在内，从而增加可执行文件的大小。缺省值为 -xbinopt=off。

B.2.71 -xbuiltin[=( %all|%none)]

如果要改进调用标准库函数的代码的优化，请使用 -xbuiltin[=(%all|%none)] 命令。很多标准库函数（例如在 math.h 和 stdio.h 中定义的函数）通常由多个程序使用。此命令使编译器可在对性能有益时替换内函数或内联系统函数。有关如何读取目标文件中的编译器注解来确定编译器实际对哪些函数进行替换的说明，请参见 er_src(1) 手册页。

但是，这些替换会使 errno 的设置变得不可靠。如果您的程序依赖于 errno 的值，请不要使用此选项。另请参见2.10 errno 的值。

如果不指定 -xbuiltin，则缺省值为 -xbuiltin=%none，该值表示不替换或内联标准库中的任何函数。如果指定 -xbuiltin，但未提供任何参数，则缺省值为 -xbuiltin%all，该值表示编译器在确定优化好处时替换内函数或内联标准库函数。

如果使用 -fast 进行编译，则 -xbuiltin 设置为 %all。

-xbuiltin 仅内联系统头文件中定义的全局函数，从不内联用户定义的静态函数。

B.2.72 -xCC

当指定 -xc99=none 和 -xCC 时，编译器将接受 C++ 样式注释。特别地，可使用 // 来指明注释的开始。

B.2.73 -xc99[= o]

-xc99 选项可控制编译器对根据 C99 标准（ISO/IEC 9899:1999，编程语言 - C）实现的功能的识别。

o 可以是包含以下内容的以逗号分隔的列表：

如果未指定 -xc99，编译器缺省采用 -xc99=all,no_lib。如果指定了 -xc99，但没有指定任何值，该选项将设置为 -xc99=all。

虽然编译器支持级别缺省为 C99 标准的语言功能，但 /usr/include 中的 Solaris 8 和 Solaris 9 操作系统提供的标准头文件不符合 1999 ISO/IEC C 标准。如果遇到错误消息，请尝试指定 -xc99=none，从而获取这些头文件的 1990 ISO/IEC C 标准行为。

出现在 1999 和 1999 C 标准中的 1990 C 标准例程库语义不可用，因此无法在 Solaris 8 和 Solaris 9 软件中启用。在 Solaris 8 或 Solaris 9 软件上直接或间接指定 -xc99=lib 时，编译器会发出错误消息。

B.2.74 -xcache[= c]

定义可供优化器使用的缓存属性。该选项不保证使用任一特定的缓存属性。

尽管该选项可单独使用，但它是 -xtarget 选项扩展的一部分；其主要用途是覆盖 -xtarget 选项提供的值。

此发行版引入一个可选属性 [/ti]，该属性用来设置可以共享缓存的线程数。如果不为 t 指定值，缺省值将为 1。

c 必须是以下值之一：

• generic

• native

• s1/l1/a 1[/t1]

• s1/l1/a 1[/t1]:s2/l 2/a2[ /t2]

• s1/l1/a 1[/t1]:s2/l 2/a2[ /t2]:s3/l 3/a3[ /t3]

s/l /a/t 属性定义如下：

下表列出了 -xcache 值。

示例：-xcache=16/32/4:1024/32/1 指定以下内容：

B.2.75 –xcg[89| 92]

(SPARC) 已废弃。您不该使用此选项。当前的 Solaris 操作系统不再支持 SPARC V7 体系结构。如果使用此选项进行编译，则生成的代码在当前的 SPARC 平台中运行较慢。应改用 -O，并利用 -xarch、-xchip 和 -xcache 编译器缺省值。

B.2.76 -xchar[= o]

提供此选项仅仅是为了便于从将字符类型定义为无符号的系统中迁移代码。如果不是从这样的系统中迁移，请不要使用该选项。只有那些依赖字符类型符号的代码才需要重写，以显式指定带符号或者无符号。

o 可以是下列值之一：

如果未指定 -xchar，编译器将假定 -xchar=s。

如果指定了 -xchar 但未指定值，编译器将假定 -xchar=s。

-xchar 选项会更改用 -xchar 编译的代码中类型 char 的值范围。该选项不更改任何系统例程或头文件中类型 char 的值范围。具体来讲，指定选项时不更改 limits.h 定义的 CHAR_MAX 和 CHAR_MIN 的值。因此，CHAR_MAX 和 CHAR_MIN 不再表示无格式字符中可编码的值的范围。

如果使用 -xchar，则在将字符与预定义的系统宏进行比较时要特别小心，原因是宏中的值可能带符号。任何返回错误代码而且可以用宏来访问错误代码的例程通常是这样的。错误代码一般是负值，因此在将字符与此类宏中的值进行比较时，结果始终为假。负数永远不等于无符号类型的值。

强烈建议不要使用 -xchar 为通过库导出的任何接口编译例程。Solaris ABI 将类型 char 指定为带符号，并且系统库也按此指定。还未对系统库针对将 char 指定为无符号的效果进行广泛测试。可以不使用该选项，而修改您的代码使其不依赖于类型 char 是否带符号。类型 char 的符号因不同的编译器和操作系统而不同。

B.2.77 -xchar_byte_order[= o]

以指定的字节顺序放置多字符字符常量构成的字符，以生成一个整型常量。可将 o 替换成下列值之一：

• low：按由低到高的字节顺序放置多字符字符常量构成的字符。

• high：按由高到低的字节顺序放置多字符字符常量构成的字符。

• default：按编译模式B.2.63 -X[c|a| t|s]所确定的顺序放置多字符字符常量构成的字符。有关更多信息，请参见2.1.2 字符常量。

B.2.78 -xcheck[= o]

(SPARC) 如果使用 -xcheck=stkovf 进行编译，将针对单线程程序中的主线程栈溢出以及多线程程序中的从属线程栈溢出添加运行时检查。如果检测到栈溢出，则生成 SIGSEGV。如果您的应用程序需要以不同于处理其他地址空间违规的方式处理栈溢出导致的 SIGSEGV，请参见 sigaltstack(2)。

可将 o 替换成下列值之一：

如果未指定 -xcheck，则编译器缺省采用 -xcheck=%none。如果指定了 -xcheck，但未指定任何参数，则编译器缺省采用 -xcheck=%all，即打开对栈溢出的运行时检查。

在命令行上 -xcheck 选项不进行累积。编译器按照上次出现的命令设置标志。

B.2.79 -xchip[= c]

指定供优化器使用的目标处理器。

c 必须是以下值之一：generic、old、super、super2、micro、micro2、hyper、hyper2、powerup、ultra、ultra2、ultra2e、ultra2i、ultra3、ultra3cu、386、486、pentium、pentium_pro。

尽管该选项可单独使用，但它是 -xtarget 选项扩展的一部分；其主要用途是覆盖 -xtarget 选项提供的值。

此选项通过指定目标处理器来指定计时属性。其部分影响表现在以下方面：

• 指令的顺序，即调度

• 编译器使用分支的方法

• 语义上等价的其他指令可用时使用的指令

下表列出了用于 SPARC 平台的 -xchip 值：

下表列出了用于 x86 平台的 -xchip 值：

B.2.80 -xcode[= v]

(SPARC) 指定代码地址空间。

强烈建议您通过指定 -xcode=pic13 或 -xcode=pic32 来生成共享对象。可以使用 -xarch=v9 -xcode=abs64 和 -xarch=v8 -xcode=abs32 生成可用的共享对象，但这样做效率很低。用 -xarch=v9、-xcode=abs32 或 -xarch=v9、-xcode=abs44 生成的共享对象无法工作。

v 必须是以下项之一：

32 位体系结构的缺省值为 -xcode=abs32。64 位体系结构的缺省值为 -xcode=abs44。

生成共享动态库时，-xcode 缺省值 abs44 和 abs32 无法与 64 位体系结构一同使用。可改为指定 -xcode=pic13 或 -xcode=pic32。在 SPARC 上使用 – xcode=pic13 和 – xcode=pic32 时，存在两项名义性能成本。

• 用 – xcode=pic13 或 – xcode=pic32 编译的例程会在入口点执行一些附加指令，以将寄存器设置为指向用于访问共享库的全局或静态变量的表 (_GLOBAL_OFFSET_TABLE_) 。

• 对全局或静态变量的每次访问都会涉及通过 _GLOBAL_OFFSET_TABLE_ 的额外间接内存引用。如果编译包括 -xcode=pic32，则每个全局和静态内存引用中都会有两个附加指令。

在考虑上述成本时，请记住：由于受到库代码共享的影响，使用 -xcode=pic13 和 -xcode=pic32 可显著降低系统内存需求。共享库中使用 -xcode=pic13 或 – xcode=pic32 编译的每个代码页都可以由使用该库的每个进程共享。如果共享库中的代码页包含非 pic（即绝对）内存引用，即使仅包含单个非 pic 内存引用，该页也将变为不可共享，而且每次执行使用该库的程序时都必须创建该页的副本。

确定是否已经使用 -xcode=pic13 或– xcode=pic32 编译 .o 文件的最简单方法是使用 nm 命令：

% nm file.o | grep _GLOBAL_OFFSET_TABLE_ U _GLOBAL_OFFSET_TABLE_

包含与位置无关的代码的 .o 文件将包含对 _GLOBAL_OFFSET_TABLE_ 无法解析的外部引用（用字母 U 标记）。

要确定使用 – xcode=pic13 还是 – xcode=pic32，请使用 elfdump -c（有关更多信息，请参见 elfdump(1) 手册页）检查全局偏移表 (Global Offset Table, GOT) 的大小并查找节标题 sh_name: .got。sh_size 值是 GOT 的大小。如果 GOT 小于 8,192 字节，请指定 -xcode=pic13，否则指定 -xcode=pic32。

通常，应根据以下准则来确定如何使用 -xcode：

• 如果是生成可执行文件，则不应该使用 – xcode=pic13 或 -xcode=pic32。

• 如果是生成仅用于链接到可执行文件的归档库，则不应该使用 – xcode=pic13 或 -xcode=pic32。

• 如果要生成共享库，请先使用 – xcode=pic13，一旦 GOT 大小超过 8,192 字节，再使用 -xcode=pic32。

• 如果要生成用于链接到共享库的归档库，则应该使用 -xcode=pic32。

B.2.81 -xcrossfile[= n]

跨源文件启用优化和内联。如果指定该选项，n 可为 0 或 1。

缺省值为 -xcrossfile=0，该设置指定不执行跨文件优化。-xcrossfile 与 -xcrossfile=1 等效。

请参考下列命令行示例：

example% cc -xcrossfile -xO4 -c f1.c f2.c
example% cc -xcrossfile -xO4 -c f3.c f4.c

跨模块优化发生在文件 f1.c 和 f2.c 之间，以及 f3.c 和 f4.c 之间。在 f1.c 和 f3.c 或 f4.c 之间不发生优化。

通常，在命令行上编译器的分析范围限于每个独立的文件。例如，-xO4 的自动内联处理仅限于同一源文件中定义和引用的子程序。

编译器使用 -xcrossfile 可以分析在命令行上指定的所有文件，好像这些文件被连接到单一的源文件中一样。仅当与 -xO4 或 -xO5 一起使用时，-xcrossfile 才有效。

但是，如果通过指定 -S 选项指示编译器生成汇编源文件，此选项将无效。汇编 (.s) 文件不参与跨源文件的优化和内联。

这种编译所产生的文件由于可能的内联而相互依赖，而且在将这些文件链接到程序时必须将其作为一个整体使用。如果更改了任何一个例程并重新编译了文件，则必须重新编译所有的文件。因此，使用此选项将会影响 make 文件的构成。

另请参见 -xldscope。

B.2.82 -xcsi

允许 C 编译器接受在不符合 ISO C 源字符代码要求的语言环境中编写的源代码。这些语言环境包括：ja_JP.PCK。

处理此类语言环境所需的编译器转换阶段可能导致编译时间明显延长。仅当编译的源文件包含此类语言环境中某个语言环境的源代码字符时，才应该使用此选项。

除非指定 -xcsi，否则编译器不识别在不符合 ISO C 源字符代码要求的语言环境中编写的源代码。

B.2.83 -xdebugformat=[stabs|dwarf]

如果您维护的软件可读取 dwarf 格式的调试信息，请指定 -xdebugformat=dwarf。使用此选项，编译器会生成使用 dwarf 标准格式的调试信息，这是缺省设置。

如果未指定 -xdebugformat，编译器将假定 -xdebugformat=dwarf。此选项需要一个参数。

此选项会影响使用 -g 选项记录的数据的格式。即使在没有使用 -g 的情况下记录少量调试信息，此选项仍可控制其信息格式。因此，即使不使用 -g，-xdebugformat 仍有影响。

dbx 和性能分析器软件可识别 stabs 和 dwarf 格式，因此使用此选项对任何工具的功能都没有影响。

有关更多信息，另请参见 dumpstabs(1) 和 dwarfdump(1) 手册页。

B.2.84 -xdepend=[yes| no]

(SPARC) 分析循环以了解迭代间数据依赖性并执行循环重构。

循环重构包括循环交换、循环合并、标量替换和“死”数组赋值消除。如果优化级别不是 -xO3 或更高级别，编译器会将优化级别提高到 -xO3 并发出警告。

如果未指定 -xdepend，缺省设置将为 -xdepend=no，该设置表示编译器不分析循环以了解数据依赖性。如果指定 -xdepend 但未指定参数，编译器会将此选项设置为 -xdepend=yes，该设置表示编译器分析循环以了解数据依赖性。

使用 -xautopar 或 -xparallel 时也包括依赖性分析。依赖性分析在编译时完成。

依赖性分析在单处理器系统中可能很有用。但是，如果在单处理器系统中尝试使用 -xdepend，则不应使用 -xautopar 或 -xexplicitpar。如果打开上述任一设置，则会为多处理器系统执行 -xdepend 优化。

B.2.85 -xdryrun

此选项是用于 -### 的宏。

B.2.86 -xe

对源文件仅执行语法和语义检查，但不生成任何目标或可执行代码。

B.2.87 -xexplicitpar

(SPARC) 已废弃，请不要使用。应改用 -xopenmp。

-xexplicitpar 不接受 OpenMP 并行化指令。但是，Sun 特定的 MP pragma 已被废弃，不再受支持。但是，编译器改为支持 OpenMP 2.5 标准指定的 API。有关标准的指令的迁移信息，请参见《Sun Studio 12: OpenMP API User’s Guide》。

(SPARC) 根据 #pragma MP 指令的规范生成并行化的代码。您可以进行依赖性分析：分析和指定循环以了解迭代间数据依赖性。该软件会使指定的循环并行化。如果优化级别不是 -xO3 或更高级别，则将优化级别提高到 -xO3 并发出警告。如果执行自己的线程管理，则不要使用 -xexplicitpar。

要使代码的运行速度更快，则该选项需要多处理器系统。在单处理器系统中，生成的代码通常运行得较慢。

如果指定某个要并行化的循环且该循环具有依赖性，您可能会得到错误的结果，有可能每次运行的结果都不相同且不发出警告。请勿将显式并行 pragma 应用于约简循环。执行显式并行化，但不执行循环的约简，因此结果可能不正确。

总之，要显式并行化，请执行以下步骤：

• 分析循环以查找可安全并行化的代码。

• 插入 #pragma MP 以并行化循环。有关更多信息，请参见3.8.3 显式并行化和 Pragma。

• 使用 -xexplicitpar 选项。

以下是一个紧挨循环之前插入并行 pragma 的示例：

#pragma MP taskloop
  for (j=0; j<1000; j++){
  ...
  }

如果使用 -xexplicitpar，而且在同一步骤中进行编译和链接，则链接将自动包括微任务化库和线程安全的 C 运行时库。如果使用 -xexplicitpar，而且在不同的步骤中进行编译和链接，则还必须使用 -xexplicitpar 进行链接。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

请勿同时指定 -xexplicitpar 和 -xopenmp。

B.2.88 -xF[=v[, v...]]

由链接程序对函数和变量进行最优的重新排序。

该选项指示编译器将函数和/或数据变量放置到单独的分段中，这使链接程序（使用链接程序的 -M 选项指定的映射文件中的指示）将这些段重新排序以优化程序性能。通常，该优化仅在缺页时间构成程序运行时间的一大部分时才有效。

对变量重新排序有助于解决对运行时性能产生负面影响的以下问题：

• 在内存中存放位置很近的无关变量会造成缓存和页的争用。

• 在内存中存放位置很远的相关变量会造成不必要的过大工作集。

• 未用到的弱变量副本会造成不必要的过大工作集，从而降低有效数据密度。

为优化性能而对变量和函数进行重新排序时，需要执行以下操作：

1. 使用 -xF 进行编译和链接。

2. 按照《程序性能分析工具》手册中关于如何生成函数的映射文件（或“链接程序和库向导”中关于如何生成数据的映射文件）的说明进行操作。

3. 通过使用链接程序的 -M 选项与新的映射文件重新链接。

4. 在分析器下重新执行以验证是否增强。

B.2.88.1 值

v 可以是下列其中一个或多个值：

如果未指定 -xF，则缺省值为 -xF=%none。如果指定了 -xF 但没有指定任何参数，则缺省值为 -xF=%none,func。

使用 -xF=lcldata 会限制某些地址计算优化，因此，只应在必要时才使用该标志。

请参见 analyzer(1)、debugger(1) 和 ld(1) 手册页。

B.2.89 -xhelp=f

显示联机帮助信息。

f 必须为 flags 或 readme。

-xhelp=flags 显示编译器选项汇总信息。

-xhelp=readme 显示 README 文件。

B.2.90 -xhwcprof

(SPARC) 使编译器支持基于硬件计数器的文件配置。

启用 -xhwcprof 后，编译器会生成信息来帮助工具将已配置的装入和存储指令与其引用的数据类型和结构成员相关联（结合使用 -g 生成的符号信息）。它将配置数据与目标数据空间而不是指令空间相关联，并提供对行为的洞察，这是仅用指令配置无法轻易获得的。

可使用 -xhwcprof 编译一组指定的目标文件。但是，-xhwcprof 在应用于应用程序中的所有目标文件时，作用最大。它能全面识别并关联分布在应用程序目标文件中的所有内存引用。

如果分别在单独的步骤中进行编译和链接，最好在链接时使用 -xhwcprof。如果将来扩展为 -xhwcprof，则在链接时可能需要使用它。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

-xhwcprof=enable 或 -xhwcprof=disable 的实例将会覆盖同一命令行中 -xhwcprof 的所有以前的实例。

在缺省情况下，禁用 -xhwcprof。指定不带任何参数的 -xhwcprof 与 -xhwcprof=enable 等效。

-xhwcprof 要求启用优化并将调试数据的格式设置为 DWARF (-xdebugformat=dwarf)。

-xhwcprof 和 -g 的组合会增加编译器临时文件的存储需求，而且比单独指定 -xhwcprof 和 -g 所引起的增加总量还多。

下列命令可编译 example.c，并可为硬件计数器文件配置以及针对使用 DWARF 符号的数据类型和结构成员的符号分析指定支持：

example% cc -c -O -xhwcprof -g -xdebugformat=dwarf example.c

有关基于硬件计数器的文件配置的更多信息，请参见《程序性能分析工具》手册。

B.2.91 -xinline=list

用于 -xinline 的 list 的格式如下所示：[{%auto,func_name ,no%func_name}[,{%auto,func_name,no%func_name}]...]

-xinline 尝试只内联可选列表中指定的函数。该列表可为空，或者由逗号分隔的 func_name、no%func_name 或 %auto 列表组成，其中 func_name 是函数名称。仅在 -xO3 或更高级别上，-xinline 才起作用。

该列表值从左至右进行累积。因此对于 -xinline=%auto,no%foo 的规范，编译器试图内联除 foo 之外的所有函数。对于 -xinline=%bar,%myfunc,no%bar 的规范，编译器仅尝试内联 myfunc。

在优化级别为 -xO4 或更高级别上编译时，编译器通常尝试内联源文件中定义的对函数的所有引用。通过指定 -xinline 选项，您可以限定编译器试图内联的函数集。如果只指定 -xinline=，即不指定任何函数或 %auto，这表示不内联源文件中的任何例程。如果您指定了一系列 func_name 和 no%func_name，而未指定 %auto，则编译器只试图内联列表中指定的函数。如果在优化级别设置为 -xO4 或更高级别时用 -xinline 选项在值列表中指定 %auto，编译器将试图内联所有未被 no%func_name 显式排除的函数。

如果以下任何条件适用，则不内联函数。且不发出任何警告。

• 优化级别低于 -xO3。

• 无法找到例程。

• 优化器无法内联例程。

• 正编译的文件中不存在该例程的源代码（请参见 -xcrossfile）。

如果在命令行指定多个 -xinline 选项，它们将不会累积。命令行上的最后一个 -xinline 指定编译器试图内联的函数。

另请参见 -xldscope。

B.2.92 -xinstrument=[ no%]datarace

指定该选项可对程序进行编译和校验，以便线程分析器进行分析。有关线程分析器的详细信息，请参见 tha(1)。

而后可以使用性能分析器运行已使用 collect -r races 校验的程序，来创建数据争用检测试验。可以独立运行已校验的代码，但其运行速度较慢。

可以指定 -xinstrument=no%datarace 关闭针对线程分析器准备源代码的功能。这是缺省设置。

指定 -xinstrument 而不带参数是非法操作。

如果在不同的步骤中进行编译和链接，则必须在编译和链接步骤中都指定 -xinstrument=datarace。

该选项定义了预处理程序标记 __THA_NOTIFY。可以指定 #ifdef __THA_NOTIFY 来保护对 libtha(3) 例程的调用。

该选项还设置 -g。

B.2.93 -xipo[= a]

(SPARC) 用 0、1 或 2 替换 a。不带任何参数的 -xipo 与 -xipo=1 等效。-xipo=0 是缺省设置，并会关闭 -xipo。在 -xipo=1 时，编译器会跨所有源文件执行内联。

在 -xipo=2 时，编译器执行过程间调用别名分析同时优化内存分配和布局，以提高缓存的性能。

编译器可通过调用过程间分析组件执行部分程序优化。不同于 -xcrossfile，-xipo 在链接步骤中跨所有目标文件执行优化，并且不限于编译命令的源文件。但是，正如 -xcrossfile 一样，使用 -xipo 执行的整个程序优化不包括汇编 (.s) 源文件。

编译时和链接时都必须指定 -xipo。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

由于跨文件执行优化时需要附加信息，因此 -xipo 选项会生成更大的目标文件。不过，该附加信息不会成为最后可执行的二进制文件的一部分。可执行程序大小的增加都是由于执行的附加优化导致的。在编译步骤中创建的目标文件具有在这些文件内编译的附加分析信息，这样就可以在链接步骤中执行跨文件优化。

在编译和链接大型多文件应用程序时，-xipo 特别有用。使用此标志编译的目标文件具有在其内部编译的分析信息，这样就可以跨源文件和预编译的程序文件进行过程间分析。

不过，分析和优化只限于用 -xipo 编译的目标文件，而不扩展到库或目标文件。

-xipo 是多阶段的，因此如果要在单独的步骤中进行编译和链接，需要为每一步指定 -xipo。

关于 -xipo 的其他重要信息：

• 它要求优化级别最低为 -xO4。

• 它与 -xcrossfile 冲突。如果一起使用它们，则会产生编译错误。

• 没有使用 -xipo 编译的对象可以自由地与使用 -xipo 编译的对象链接。

B.2.93.1 示例

在此例中，编译和链接在单独的步骤中进行：

cc -xipo -xO4 -o prog part1.c part2.c part3.c

优化器在三个源文件之间执行交叉文件内联。这是在最终链接步骤中完成的，因此源文件的编译不必全部在单个编译中进行，可以通过多个单独的编译来进行，且每个编译都要指定 -xipo。

在此例中，编译和链接在单独的步骤中进行：

cc -xipo -xO4 -c part1.c part2.c
cc -xipo -xO4 -c part3.c
cc -xipo -xO4 -o prog part1.o part2.o part3.o

即使用 -xipo 编译，仍存在库不参与交叉文件过程间分析的约束，如下例所示：

cc -xipo -xO4 one.c two.c three.c
ar -r mylib.a one.o two.o three.o
...
cc -xipo -xO4 -o myprog main.c four.c mylib.a

在此例中，过程间调用优化是在以下例程之间执行的：one.c、two.c 和 three.c 之间，main.c 和 four.c 之间，但不在 main.c 或 four.c 和 mylib.a 上的例程之间执行。（第一次编译可能产生未定义符号警告，但是由于它是编译与链接步骤，所以会执行过程间调用优化。）

B.2.93.2 何时不使用 -xipo=2 过程间分析

在链接步骤中使用目标文件集合时，编译器试图执行整个程序分析和优化。对于该目标文件集合中定义的任何函数或子例程 foo()，编译器做出以下两个假定：

• foo() 无法在运行时被在该目标文件集合之外定义的其他例程显式调用。

• 来自该目标文件集合中的任何例程的 foo() 调用将不受在该目标文件集合以外定义的不同版本的 foo() 的干预。

如果假定 2 不成立，则既不要使用 -xipo=1 也不要使用 -xipo=2 编译。

例如，考虑使用您自己的版本干预函数 malloc() 并使用 -xipo=2 编译。因此，任何库中引用与您的代码链接的 malloc() 的所有函数也必须使用 -xipo=2 编译，并且它们的目标文件需要参与链接步骤。由于这对于系统库不大可能，因此不要使用 -xipo=2 编译您的 malloc 版本。

另举一例，假设您使用位于两个不同源文件中的两个外部调用 foo() 和 bar() 生成一个共享库。然后，假设 bar() 调用 foo()。如果有可能在运行时干预 foo()，则不要使用 -xipo=1 或 -xipo=2 编译 foo() 或 bar() 的源文件。否则，foo() 会内联到 bar() 中，从而导致出现错误的结果。

B.2.94 -xipo_archive=[a]

-xipo_archive 选项使编译器可在生成可执行文件之前用通过 -xipo 编译的目标文件以及归档库 (.a) 中的目标文件来优化传递给链接程序的目标文件。库中包含的在编译期间优化的任何目标文件都会替换为其优化后的版本。

a 是以下项之一：

如果不为 -xipo_archive 指定设置，编译器会将其设置为 -xipo_archive=none。

指定不带标志的 -xipo_archive 为非法操作。

B.2.95 -xjobs=n

(SPARC) 指定 -xjobs 选项，以设置编译器为完成工作需要创建的进程数。在多 cpu 计算机上，该选项可以缩短生成时间。目前，-xjobs 只能与 -xipo 一起使用。如果指定 -xjobs=n，过程间优化器就将 n 作为其在编译不同文件时可调用的最大代码生成器实例数。

通常，n 的安全值等于 1.5 乘以可用处理器数。如果使用的值是可用处理器数的数倍，则会降低性能，因为有在产生的作业间进行的上下文切换开销。此外，使用很大的数值会耗尽有限的系统资源（如交换空间）。

指定 -xjobs 时务必要指定值。否则，会发出错误诊断，并且编译中止。

出现最合适的实例之前，-xjobs 的多重实例在命令行上会互相覆盖。

以下示例在有两个处理器的系统上进行的编译，速度比使用相同命令但没有 -xjobs 选项时进行的编译快。

 example% cc -xipo -xO4 -xjobs=3 t1.c t2.c t3.c

指定不带标志的 -xipo_archive 为非法操作。

B.2.96 -xldscope={v}

指定 -xldscope 选项，以更改用于外部符号定义的缺省链接程序作用域。由于实现更隐蔽，因此更改缺省值可使共享库更快、更安全。

v 必须是下列值之一：

如果未指定 -xldscope，编译器将假定 -xldscope=global。如果指定不带参数的 -xldscope，编译器会发出错误信息。在到达最右边的实例之前，命令行上此选项的多个实例相互覆盖。

如果要使客户端覆盖库中的函数，就必须确保该库生成期间未以内联方式生成该函数。编译程序在以下情况下将内联函数：用 -xinline 指定函数的名称、在可以自动内联的 -xO4 或更高级别进行编译、使用内联说明符、使用内联 pragma 或者使用交叉文件优化。

例如，假定库 ABC 具有缺省的分配器函数，该函数可用于库的客户端，也可在库的内部使用：

void* ABC_allocator(size_t size) { return malloc(size); }

如果在 -xO4 或更高级别生成库，则编译器将内联库组件中出现的对 ABC_allocator 的调用。如果库的客户端要用定制的版本替换 ABC_allocator，则在调用 ABC_allocator 的库组件中不能进行该替换。最终程序将包括函数的不同版本。

生成库时，用 __hidden 或 __symbolic 说明符声明的库函数可以内联生成。假定这些库函数不被客户端覆盖。请参见2.2 链接程序作用域说明符。

用 __global 说明符声明的库函数不应内联声明，并且应该使用 -xinline 编译器选项来防止内联。

另请参见 -xinline、-xO、-xcrossfile、#pragma、inline。

B.2.97 -xlibmieee

强制为异常类中的数学例程返回 IEEE 754 样式的值。在此情况下，不打印异常消息，并且不应依赖 errno。

B.2.98 -xlibmil

内联一些库例程，以加快执行速度。此选项可为浮点选项和系统平台选择合适的汇编语言内联模板。

无论将函数的任何规范作为 -xlibmil 标记的一部分，-xlibmil 都会内联函数。

但是，这些替换会导致 errno 的设置变得不可靠。如果您的程序依赖于 errno 的值，请尽量不要使用此选项。另请参见2.10 errno 的值。

B.2.99 -xlibmopt

使编译器可以使用优化数学例程的库。使用此选项时，必须通过指定 -fround=nearest 来使用缺省舍入模式。

数学例程库优化了性能，并且通常会生成运行速度更快的代码。结果可能与普通数学库产生的结果略有不同。如果有差别，通常是最后一位不同。

但是，这些替换会使 errno 的设置变得不可靠。如果您的程序依赖于 errno 的值，请不要使用此选项。另请参见2.10 errno 的值。

该库选项在命令行上的顺序并不重要。

此选项由 -fast 选项设置。

另请参见：-fast -xnolibmopt

B.2.100 -xlic_lib=sunperf

Sun 提供的性能库中的链接。

B.2.101 -xlicinfo

编译器忽略此选项且不显示任何提示。

B.2.102 -xlinkopt[= level]

(SPARC) 指示编译器对可重定位的目标文件执行链接时优化。这些优化在链接时通过分析二进制目标代码来执行。虽然未重写目标文件，但产生的可执行代码可能与初始目标代码不同。

必须至少在部分编译命令中使用 -xlinkopt，才能使 -xlinkopt 在链接时有效。优化器仍可以对未使用 -xlinkopt 进行编译的二进制目标文件执行部分受限的优化。

-xlinkopt 优化出现在编译器命令行上的静态库代码，但会跳过出现在命令行上的共享（动态）库代码而不对其进行优化。还可以在生成共享库（用 -G 编译）时使用 -xlinkopt。

级别必须将执行的优化级别设置为 0、1 或 2。各优化级别如下所示：

如果在不同的步骤中编译，-xbinopt 必须同时出现在编译和链接步骤中：

example% cc -c -xlinkopt a.c b.c
example% cc -o myprog -xlinkopt=2 a.o

有关在编译和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

注意，仅当链接编译器时才使用级别参数。在以上示例中，即使二进制目标代码是用隐含级别 1 编译的，使用的后优化级别仍然是 2。

指定 -xlinkopt 时若不带级别参数，则表示 -xlinkopt=1。

当编译整个程序并且使用配置文件反馈时，该选项才最有效。文件配置会显示代码中最常用和最少用的部分并相应地指导优化器集中其努力方向。这对大型应用非常重要，因为链接时执行代码的优化放置可以减少指令的高速缓存缺失。通常，编译如下所示：

example% cc -o progt -xO5 -xprofile=collect:prog file.c
example% progt
example% cc -o prog -xO5 -xprofile=use:prog -xlinkopt file.c

有关使用配置文件反馈的详细信息，请参见B.2.131 -xprofile=p。

使用 -xlinkopt 编译时，请不要使用 -zcompreloc 链接程序选项。

注意，使用该选项编译会略微延长链接的时间，也会增加目标文件的大小，但可执行文件的大小保持不变。使用 -xlinkopt 和 -g 编译会将调试信息包括在内，从而增加了可执行文件的大小。

B.2.103 -xloopinfo

(SPARC) 显示已并行化和尚未并行化的循环。简要说明循环未并行化的原因。仅当指定了 -xautopar、-xparallel 或 -xexplicitpar 时，-xloopinfo 选项才有效，否则，编译器将发出警告。

要达到更快的执行速度，则该选项需要多处理器系统。在单处理器系统中，生成的代码通常运行得较慢。

B.2.104 -xM

只对指定的 C 程序运行预处理程序，请求它生成 make 程序描述文件依赖性并将结果发送至标准输出（有关 make 文件和依赖性的详细信息，请参见 make(1)）。

例如：

#include <unistd.h>
void main(void)
{}

生成的输出如下：

e.o: e.c
e.o: /usr/include/unistd.h
e.o: /usr/include/sys/types.h
e.o: /usr/include/sys/machtypes.h
e.o: /usr/include/sys/select.h
e.o: /usr/include/sys/time.h
e.o: /usr/include/sys/types.h
e.o: /usr/include/sys/time.h
e.o: /usr/include/sys/unistd.h

B.2.105 -xM1

收集类似 -xM 的依赖性，但不包括 /usr/include 文件。例如：

more hello.c
#include<stdio.h>
main()
{
    (void)printf(“hello\n”);
}
cc– xM hello.c
hello.o: hello.c
hello.o: /usr/include/stdio.h

使用 -xM1 编译不会报告头文件的依赖性：

cc– xM1 hello.c
hello.o: hello.c

-xM1 在 -Xs 模式下不可用。

如果指定 -xM1 和 -xMF，编译器会将所有 makefile 依赖关系信息附加到使用-xMF 所指定的文件中。

B.2.106 -xMD

用于生成 makefile 依赖关系（与 -xM 的功能相同），只是它还包括编译功能。-xMD 用于根据 输入的文件名为 makefile 依赖关系信息生成输出文件，只是添加了一个 .d 后缀。 如果指定 -xMD 和 -xMF，预处理程序会将所有 makefile 依赖关系信息附加到使用 -xMF 所指定的文件中。

B.2.107 -xMF 文件名

使用 此选项可为 makefile 依赖关系输出指定一个文件。无法在一个命令行上使用 -xMF 为多个输入文件分别指定文件名。

B.2.108 -xMMD

使用 此选项可生成 makefile 依赖关系（系统头文件除外）。此选项与 -xM1 的功能相同，只是它还包括编译功能。-xMMD 用于根据输入的文件名为 makefile 依赖关系生成输出文件，只是添加了一个 .d 后缀。 如果指定 -xMF，编译器将改用您所提供的文件名。

B.2.109 -xMerge

将数据段合并为文本段。在此编译所生成的目标文件中初始化的数据是只读数据，并可（除非用 ld-N 链接）在进程间共享。

B.2.110 -xmaxopt[=v]

此命令可将 pragma opt 的级别限制为指定级别。v 是 off、1、2、3、4、5 中的一个值。缺省值为 -xmaxopt=off，该值导致 pragma opt 被忽略。如果指定 -xmaxopt 而不提供参数，则与指定 -xmaxopt=5 等效。

如果同时指定了 -xO 和 -xmaxopt，则使用 -xO 设置的优化级别不能超过 -xmaxopt 值。

B.2.111 -xmemalign=ab

(SPARC) 指定最大假定内存对齐和未对齐数据访问行为。必须有一个同时用于 a（对齐）和 b（行为）的值。a 指定最大假定内存对齐，b 指定未对齐内存访问行为。下表列出了 -xmemalign 的对齐和行为的值：

如果要链接到某个已编译的目标文件，并且编译该目标文件时 b 的值设置为 i 或 f，就必须指定 -xmemalign。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

对于可在编译时确定对齐的内存访问，编译器会为该数据对齐生成适当的装入/存储指令序列。

对于不能在编译时确定对齐的内存访问，编译器必须假定一个对齐以生成所需的装入/存储序列。

-xmemalign 选项允许您在这些未确定情况下指定编译器要假定的数据最大内存对齐。它还指定在运行时发生未对齐内存访问时要执行的错误行为。

以下缺省值仅适用于未使用 -xmemalign 选项时：

• -xmemalgin=8i（适于所有 v8 体系结构）。

• -xmemalign=8s（适于所有 v9 体系结构）。

在出现 -xmemalign 选项但未给定任何值时，缺省值为：

• -xmemalign=1i（对于所有 -xarch 值）。

下表说明了如何使用 -xmemalign 来处理不同的对齐情况。

B.2.112 -xmodel=[a]

(x86) -xmodel 选项使编译器可为 Solaris x86 平台修改 64 位对象的格式，只能为此类对象的编译指定此选项。

仅当在支持 64 位的 x64 处理器上同时指定了 -m64 时，该选项才有效。

a 必须是以下值之一：

此选项不累积，因此编译器根据命令行最右侧的 -xmodel 实例设置模型值。

如果未指定 -xmodel，编译器将假定 -xmodel=small。指定不带参数的 -xmodel 是不正确的。

不必使用此选项编译所有转换单元。只有可以确保访问的对象在可访问范围之内，才可编译选择的文件。

请注意，并不是所有的 Linux 系统都支持中等模型。

B.2.113 -xnolib

缺省情况下不链接任何库；即不向 ld(1) 传递任何 -l 选项。通常，cc 驱动程序将 -lc 传递给 ld。

在您使用 -xnolib 时，必须自己传递所有 -l 选项。

B.2.114 -xnolibmil

不内联数学库例程。在 –fast 选项之后使用。例如：

% cc– fast– xnolibmil....

B.2.115 -xnolibmopt

通过关闭以前指定的所有 -xlibmopt 选项，禁止编译器使用优化的数学库。在 -fast 之后使用此选项（-fast 可以通过设置 -xlibmopt 允许使用优化数学库）：

% cc -fast -xnolibmopt ...

B.2.116 -xnorunpath

不将共享库的运行时搜索路径生成到可执行文件中。

通常 cc 不会将任何 -R 路径传递给链接程序。有一些选项（例如， -xliclib=sunperf 和 -xopenmp）会将 -R 路径传递给链接程序。可以使用 -xnorunpath 选项防止这种情况发生。

建议用该选项生成提交到客户（这些客户的程序使用的共享库具有不同路径）的可执行文件。

B.2.117 -xO[1|2| 3|4|5]

优化目标代码；注意大写字母 O 后跟数字 1、2、3、4 或 5。一般说来，优化级别越高，运行时性能越好。不过，较高的优化级别会延长编译时间并生成较大的可执行文件。

在少数情况下， – xO2 级别的执行可能比其他优化级别好，而 – xO3 也可能胜过 – xO4。尝试用每个级别进行编译，以查看您是否会遇到这种少见的情况。

如果优化器内存不足，它将尝试通过在较低的优化级别中重试当前的过程来进行恢复，并以命令行选项中指定的原始级别继续后续过程。

缺省为不优化。不过，只有不指定优化级别时才可能使用缺省设置。如果指定了优化级别，则没有任何选项可用来关闭优化。

如果尝试不设置优化级别，请不要指定任何隐含优化级别的选项。例如，-fast 是将优化级别设置为 -xO5 的宏选项。隐含优化级别的所有其他选项都会给出优化已设置的警告消息。不使用任何优化来编译的方法是从命令行删除所有选项或创建指定优化级别的文件。

如果使用 - g 并且优化级别为 - xO3 或更低，编译器将提供几乎进行全面优化的最佳效果符号信息。尾部调用优化和后端内联被禁用。

如果使用 - g 并且优化级别为 - xO4 或更高，编译器将提供进行全面优化的最佳效果符号信息。

使用 -g 进行调试不会抑制 -xOn，但 -xOn 会用某些方法限制 -g。例如，优化选项会降低调试的效用，以致无法显示 dbx 中的变量，但仍可使用 dbx where 命令获取符号回溯。有关更多信息，请参见《使用 dbx 调试程序》第 1 章中的“调试优化的代码”。

如果同时指定了 -xO 和 -xmaxopt，那么用 -xO 设置的优化级别不得超过 -xmaxopt 值。

如果在 -xO3 或 -xO4 级别上优化非常大的程序（在同一程序中有数千行代码），优化器可能需要大量虚拟内存。在这种情况下，机器性能可能会降低。

B.2.117.1 SPARC 优化的说明

下表描述了它们在 SPARC 平台上如何操作。

B.2.117.2 x86 优化的说明

下表描述了优化级别在 x86 平台上的工作原理。

有关调试的更多信息，请参见《Sun Studio 12：使用 dbx 调试程序》手册。有关优化的更多信息，请参见《Sun Studio 12：性能分析器》手册。

另请参见 -xldscope 和 -xmaxopt。

B.2.118 -xopenmp[= i]

使用 -xopenmp 选项可通过 OpenMP 指令启用显式并行化。要在多线程环境中运行已并行化的程序，必须在执行之前设置 OMP_NUM_THREADS 环境变量。

要启用嵌套并行操作，必须将 OMP_NESTED 环境变量设置为 TRUE。缺省情况下，禁用嵌套并行操作。

下表列出了 i 值：

如果指定 -xopenmp 但未给定值，编译器将假定 -xopenmp=parallel。如果不指定 -xopenmp，编译器将假定 -xopenmp=none。

如果使用 dbx 调试 OpenMP 程序，那么编译时选用 -g 和 -xopenmp=noopt 可以在并行区设置断点并显示变量内容。

请不要将 -xopenmp 和 -xexplicitpar 或 -xparallel 一起指定。

在以后的发行版中，-xopenmp 的缺省值可能会更改。可以通过显式指定适当的优化来避免警告消息。

如果在生成任何 .so 时使用了 -xopenmp，则链接可执行文件时必须使用 -xopenmp，并且可执行文件的编译器不得早于用 -xopenmp 生成 .so 时使用的编译器。这在编译包含 OpenMP 指令的库时尤其重要。有关在编译和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

请确保在系统上安装了最新的 OpenMP 运行时库 (libmtsk.so) 修补程序，以获得最佳性能。

有关特定于 OpenMP 的 C 实现的更多信息，请参见3.2 OpenMP 并行化。

有关 OpenMP 的信息，请参见《Sun Studio 12: OpenMP API User’s Guide》。

B.2.119 -xP

编译器对源文件仅执行语法和语义检查，以打印所有 K&R C 函数的原型。此选项不生成任何目标代码或可执行代码。例如，对以下源文件指定 -xP，

f()
{
}

main(argc,argv)
int argc;
char *argv[];
{
}

产生以下输出：

int f(void);
int main(int, char **);

B.2.120 -xpagesize=n

为栈和堆设置首选页面大小。

n 值必须是以下项之一：4k、8K、64K、512K、2M、4M、32M、256M、2G、16G 或 default。如果不指定有效的页面大小，运行时将忽略该请求，且不显示任何提示。

必须指定适于目标平台的有效页面大小。

在 Solaris 操作系统中使用 getpagesize(3C) 命令可以确定页面中的字节数。Solaris 操作系统不保证支持页面大小请求。可以使用 pmap(1) 或 meminfo(2) 来确定目标平台的页面大小。

可以使用 pmap(1) 或 meminfo(2) 来确定目标平台的页面大小。

除非在编译和链接时使用，否则 -xpagesize 选项不会生效。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

该功能只在 Solaris 8 操作系统中可用。在 Solaris 8 操作系统中不链接使用该选项编译的程序。

如果指定 -xpagesize=default，Solaris 操作系统将设置页面大小。

使用该选项进行编译与使用等效的选项将 LD_PRELOAD 环境变量设置为 mpss.so.1 或在运行程序之前使用等效的选项运行 Solaris 9 命令 ppgsz(1) 具有相同的效果。有关详细信息，请参见 Solaris 手册页。

此选项是用于 -xpagesize_heap 和 -xpagesize_stack 的宏。这两个选项与 -xpagesize 接受相同的参数：4k、8K、64K、512K、2M、4M、32M、256M、2G、16G 或 default。可以通过指定 -xpagesize 为它们设置相同值，也可以分别为它们指定不同的值。

B.2.121 -xpagesize_heap=n

在内存中为堆设置页面大小。

n 的值必须是下列值之一： 4k、8K、64K、512K、2M、4M、32M、256M、2G、16G 或 default。如果不指定有效的页面大小，运行时将忽略该请求，且不显示任何提示。

在 Solaris 操作系统中使用 getpagesize(3C) 命令可以确定页面中的字节数。Solaris 操作系统不保证支持页面大小请求。可以使用 pmap(1) 或 meminfo(2) 来确定目标平台的页面大小。

可以使用 pmap(1) 或 meminfo(2) 在目标平台中设置页面大小。

如果指定 -xpagesize_heap=default，Solaris 操作系统将设置页面大小。

使用该选项进行编译与使用等效的选项将 LD_PRELOAD 环境变量设置为 mpss.so.1 或在运行程序之前使用等效的选项运行 Solaris 9 命令 ppgsz(1) 具有相同的效果。有关详细信息，请参见 Solaris 手册页。

除非在编译和链接时使用，否则 -xpagesize_heap 选项不会生效。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

该功能只在 Solaris 8 操作系统中可用。在 Solaris 8 操作系统中不链接使用该选项编译的程序。

B.2.122 -xpagesize_stack=n

在内存中为栈设置页面大小。

n 的值必须是下列值之一：8K、64K、512K、4M、32M、256M、2G、16G 或 default。如果不指定有效的页面大小，运行时将忽略该请求，且不显示任何提示。

在 Solaris 操作系统中使用 getpagesize(3C) 命令可以确定页面中的字节数。Solaris 操作系统不保证支持页面大小请求。可以使用 pmap(1) 或 meminfo(2) 来确定目标平台的页面大小。

如果指定 -xpagesize_stack=default，Solaris 操作系统将设置页面大小。

使用该选项进行编译与使用等效的选项将 LD_PRELOAD 环境变量设置为 mpss.so.1 或在运行程序之前使用等效的选项运行 Solaris 9 命令 ppgsz(1) 具有相同的效果。有关详细信息，请参见 Solaris 手册页。

除非在编译和链接时使用，否则 -xpagesize_stack 选项不会生效。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

该功能只在 Solaris 8 操作系统中可用。在 Solaris 8 操作系统中不链接使用该选项编译的程序。

B.2.123 -xparallel

(SPARC) 已废弃，请不要使用。应改用 -xopenmp。

-xparallel 不接受 OpenMP 并行化指令。但是，Sun 特定的 MP pragma 已被废弃，不再受支持。OpenMP API 是所支持的首选并行化模型。有关标准的指令的迁移信息，请参见《Sun Studio 12: OpenMP API User’s Guide》。

由编译器自动并行化循环，同时由程序员显式指定。-xparallel 选项是一个宏，它与指定 -xautopar、-xdepend 和 -xexplicitpar 等效。如果显式并行化循环，则存在产生错误结果的风险。如果优化级别不是 -xO3 或更高级别，则将优化级别提高到 -xO3 并发出警告。

如果执行自己的线程管理，请不要使用 -xparallel。如果发出的是 -xopenmp，请不要使用 -xparallel。-xparallel 可设置指定 -xopenmp 时不应使用的 -xexplicitpar。

要使代码的运行速度更快，则该选项需要多处理器系统。在单处理器系统中，生成的代码通常运行得较慢。

如果在一个步骤中进行编译和链接，-xparallel 将链接微任务化库和线程安全的 C 运行时库。如果在不同的步骤中进行编译和链接，并且使用 -xparallel 编译，则使用 -xparallel 链接。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

B.2.124 -xpch=v

此编译器选项可激活预编译头文件功能。v 可为 auto、autofirst、collect:pch_filename 或 use:pch_filename。通过将 -xpch（在B.2.124 -xpch=v中进行了详细介绍）和 -xpchstop（在B.2.125 -xpchstop=[file|<include>]中进行了详细介绍）选项与 #pragma hdrstop 指令（在2.8.8 hdrstop中进行了详细介绍）结合使用，可利用此功能。

使用 -xpch 选项可以创建预编译头文件并减少编译时间。预编译头文件的作用是减少源代码共享同一组 include 文件的应用程序的编译时间，这些 include 文件往往包含大量的源代码。预编译头文件的工作机理是，首先从一个源文件收集一组头文件信息，然后在重新编译该源文件或者编译其他有同样头文件顺序的源文件时就可以使用这些收集到的信息。编译器收集的信息存储在预编译头文件中。

另请参见：

• B.2.125 -xpchstop=[file|<include>]。

• 2.8.8 hdrstop。

B.2.124.1 自动创建预编译头文件

可以让编译器自动生成预编译头文件。选择以下两种方法之一来实现此目的。一种方法是让编译器从在源文件找到的第一个 include 文件创建预编译头文件。另一种方法是让编译器从在源文件中找到的 include 文件集合中选择，选择范围从第一个 include 文件开始，直到已经定义好的确定哪个 include 文件是最后一个的点结束。使用以下标志之一可以确定编译器用于自动生成预编译头文件的方法：

B.2.124.2 手动创建预编译头文件

如果决定手动创建预编译头文件，则必须首先使用 -xpch，并指定 collect 模式。指定 -xpch=collect 的编译命令只能指定一个源文件。在以下示例中，-xpch 选项根据源文件 a.c 创建名为 myheader.cpch 的预编译头文件：

cc -xpch=collect:myheader a.c

有效的预编译头文件通常具有后缀 .cpch。在指定 pch_filename 时，后缀可以由您自己增加或由编译器增加。例如，如果指定 cc -xpch=collect:foo a.c，则预编译的头文件名为 foo.cpch。

B.2.124.3 编译器如何处理现有的预编译头文件

如果编译器无法使用 -xpch=auto 和 -xpch=autofirst 时的预编译头文件，则会生成新的预编译头文件。如果编译器无法使用 -xpch=use 时的预编译头文件，将发出一个警告，并且使用真实头文件来完成编译。

B.2.124.4 指示编译器使用特定的预编译头文件

您还可以指示编译器使用特定的预编译头文件。要实现此目的，请指定 -xpch=use:pch_filename。可以将 include 文件同一序列中任意数量的源文件指定为用于创建预编译头文件的源文件。例如，在 use 模式中的命令可类似于以下命令：cc -xpch=use:foo.cpch foo.c bar.c foobar.c.

如果以下条件都成立，则只能使用现有的预编译的头文件。如果以下任意条件不成立，则应重新创建预编译头文件：

• 用于访问预编译头文件的编译器与创建预编译头文件的编译器相同。由某一版本的编译器创建的预编译头文件不能被其他版本的编译器使用。

• 除 -xpch 选项之外，用 -xpch=use 指定的编译器选项必须与创建预编译头文件时指定的选项相匹配。

• 用 -xpch=use 指定的包含头文件的集合与创建预编译头文件时指定的头文件集合是相同的。

• 用 -xpch=use 指定的包含头文件的内容与创建预编译头文件时指定的包含头文件的内容是相同的。

• 当前目录（即发生编译并尝试使用给定预编译头文件的目录）与创建预编译头文件所在的目录相同。

• 在用 -xpch=collect 指定的文件中预处理指令（包括 #include）的初始序列，与在用 -xpch=use 指定的文件中预处理指令的序列相同。

B.2.124.5 活前缀

为了在多个源文件间共享预编译头文件，这些源文件就必须将通用的 include 文件集合作为其标记的初始序列共享。标记是指关键字、名称或标点符号。被 #if 指令排除的注释和代码不能被编译器识别为标记。该初始标记序列称为活前缀。也就是说，活前缀是源文件中通用于所有源文件的最靠前的部分。创建预编译头文件并进而确定源文件中哪些头文件是预编译的时，编译器使用此活前缀作为整个操作的依据。

编译器在当前编译期间找到的活前缀必须与用于创建预编译头文件的活前缀匹配。也就是说，必须在使用相同预编译头文件的所有源文件中对活前缀给出一致的解释。

源文件的活前缀只能包含注释和以下任意预处理程序指令：

#include
#if/ifdef/ifndef/else/elif/endif
#define/undef
#ident (if identical, passed through as is)
#pragma (if identical)

以上任何指令都可以引用宏。#else、#elif 和 #endif 指令必须在活前缀内匹配。注释被忽略。

指定 -xpch=auto 或 -xpch=autofirst 时，编译器自动确定活前缀的终点，定义如下：对于 -xpch=collect 或 -xpch=use，活前缀以 #pragma hdrstop 结尾。

• 第一个声明/定义语句

• 第一个 #line 指令

• #pragma hdrstop 指令

• 在指定的 include 文件之后（如果您指定 -xpch=auto 和 -xpchstop）

• 第一个 include 文件（如果您指定 -xpch=autofirst）

  ---

  注 –

  条件语句中的终点会生成一个警告，并禁止自动创建预编译头文件。另外，如果同时指定 #pragma hdrstop 和 -xpchstop 选项，编译器将使用两个停止点中较早的那一个来终止活前缀。

  ---

在共享预编译头文件的每个文件的活前缀中，每个相应的 #define 和 #undef 指令都必须引用相同的符号（例如每个 #define 必须引用同一个值）。这些指令在每个活前缀中出现的顺序也必须相同。每个相应 pragma 也必须相同，并且必须按相同顺序出现在共享预编译头文件的所有文件中。

B.2.124.6 浏览头文件以查找问题

如何能够使头文件可以预编译？在不同的源文件中解释一致时，头文件可以预编译。具体来说，就是当它仅包含完全声明时。也就是说，任何一个文件中的声明都必须独自成为有效声明。不完全的类型声明，例如 struct S;，是有效声明。完全类型声明可以出现在某些其他文件中。请考虑这些头文件示例：

file a.h
struct S {
#include "x.h" /* not allowed */
};

file b.h
struct T; // ok, complete declaration
struct S {
   int i;
[end of file, continued in another file] /* not allowed*/

并入预编译头文件的头文件一定不得违反以下约束。这里没有定义对违反上述约束的程序的编译结果。

• 头文件不得使用 __DATE__ 和 __TIME__。

• 头文件不得包含 #pragma hdrstop。

B.2.124.7 预编译头文件高速缓存

编译器自动创建预编译头文件时，会将该文件写入 SunWS_cache 目录中。此目录始终位于创建目标文件的位置。该文件的更新受锁保护，这样可在 dmake 下正常工作。

如果需要强制编译器重新生成自动生成的预编译头文件，可以使用 CCadmin 工具清除预编译头文件高速缓存目录。有关更多信息，请参见 CCadmin(1) 手册页。

B.2.124.8 警告

• 不要在命令行上指定冲突的 -xpch 标志。例如，同时指定 -xpch=collect 和 -xpch=auto 或同时指定 -xpch=autofirst 和 -xpchstop=<include> 会产生错误。

• 如果指定 -xpch=autofirst，或指定不带 -xpchstop 的 -xpch=auto，则出现在第一个 include 文件之前，或出现在使用用于 -xpch=auto 的 -xpchstop 指定的 include 文件之前的任何声明、定义或 #line 指令都会生成警告，并禁止自动生成预编译头文件。

• -xpch=autofirst 或 -xpch=auto 时的第一个 include 文件之前的 #pragma hdrstop 会禁止自动生成预编译头文件。

B.2.124.9 预编译头文件依赖性和 make 文件

指定 -xpch=collect 时，编译器会生成预编译头文件的依赖性信息。需要在 make 文件中创建适当的规则，以利用这些依赖性。考虑下面的 make 文件示例：

%.o : %.c shared.cpch
         $(CC) -xpch=use:shared -xpchstop=foo.h -c $<
default : a.out

foo.o + shared.cpch : foo.c
         $(CC) -xpch=collect:shared -xpchstop=foo.h foo.c -c

a.out : foo.o bar.o foobar.o
         $(CC) foo.o bar.o foobar.o

clean :
         rm -f *.o shared.cpch .make.state a.out

这些 make 规则以及编译器生成的依赖性，会在与 -xpch=collect 一起使用的任何源文件或属于预编译头文件的一部分的任何头文件发生更改时，强制重新创建手动创建的预编译头文件。这样可防止使用过期的预编译头文件。

您无需在 make 文件中为 -xpch=auto 或 -xpch=autofirst 创建任何其他 make 规则。

B.2.125 -xpchstop=[file|<include>]

使用 -xpchstop=file 选项可为预编译头文件指定活前缀的最后一个 include 文件。在命令行使用 -xpchstop 与将 hdrstop pragma 置于第一个包含指令之后等效，此包含指令在您使用 cc 命令指定的每个源文件中引用 file。

结合使用 -xpchstop=<include> 和 -xpch-auto 可以创建基于从其往上并包括 <include> 的头文件的预编译头文件。此标志覆盖缺省的 -xpch=auto 行为（使用整个活前缀中包含的所有头文件的行为）。

在以下示例中，-xpchstop 选项指定了预编译头文件的活前缀以 projectheader.h 的包含结束。因此，privateheader.h 不是活前缀的一部分。

example% cat a.c
     #include <stdio.h>
     #include <strings.h>
     #include "projectheader.h"
     #include "privateheader.h"
     .
     .
     .
example% cc -xpch=collect:foo.cpch a.c -xpchstop=projectheader.h -c

另请参见 -xpch。

B.2.126 -xpentium

(x86) 为 Pentium 处理器生成代码。

B.2.127 -xpg

准备目标代码，以收集用 gprof(1) 进行文件配置所需的数据。此选项调用在正常终止情况下产生 gmon.out 文件的运行时记录机制。

如果指定 -xpg，-xprofile 将没有用处。两者不能准备或使用对方提供的数据。

在 64 位 Solaris 平台上，使用 prof(1) 或 gprof(1) 生成配置文件，在 32 位 Solaris 平台上，则只使用 gprof 生成配置文件，配置文件中包括大概的用户 CPU 时间。这些时间来自主可执行文件中的例程以及共享库中例程（链接可执行文件时将共享库指定为链接程序参数）的 PC 示例数据（请参见 pcsample(2)）。其他共享库（在进程启动后使用 dlopen(3DL) 打开的库）不进行文件配置。

在 32 位 Solaris 系统中，使用 prof(1) 生成的配置文件仅限于可执行文件中的例程。32 位共享库通过用 -xpg 和 gprof(1) 链接可执行程序可以进行文件配置。

Solaris 10 软件不包括使用 -p 编译的系统库。因此，在 Solaris 10 平台上收集的配置文件不包括系统库例程的调用计数。

如果在编译时指定 -xpg，则还必须在链接时指定它。有关在编译时和链接时都必须指定的选项的完整列表，请参见A.1.2 编译时选项和链接时选项。

B.2.128 -xprefetch[= val[,val]]

(SPARC) 在支持预取的体系结构中启用预取指令。

显式预取只应在度量支持的特殊环境下使用。

val 必须是以下值之一：

缺省值为 -xprefetch=auto,explicit。此缺省值会对实质上具有非线性内存访问模式的应用程序造成负面影响。要覆盖该缺省值，请指定 -xprefetch=no%auto,no%explicit。

sun_prefetch.h 头文件提供了可用来指定显式预取指令的宏。预取的位置大约为可执行文件中对应于宏出现的位置。

B.2.128.1 预取等待时间比率

预取延迟是从执行预取指令到所预取的数据在高速缓存中可用那一刻之间的硬件延迟。

该因子必须是形式为 n.n. 的正数。

在决定放置使用预取数据的预取指令和装入或存储指令的距离时，编译器会假定预取延迟值。在预取和装入之间假定的延迟可能与在预取和存储之间假定的延迟不同。

编译器可以在众多计算机与应用程序间调整预取机制，以获得最佳性能。这种调整并非总能达到最优。对于占用大量内存的应用程序，尤其是要在大型多处理器上运行的应用程序，可以通过增加预取延迟值来提高性能。要增加值，请使用大于 1 的因子。介于 .5 和 2.0 之间的值最有可能提供最佳性能。

对于数据集完全位于外部高速缓存中的应用程序，可以通过减小预取延迟值来提高性能。要减小此值，请使用小于 1 的因子。

要使用 latx:factor 子选项，则以接近 1.0 的因子值开始并对应用程序进行性能测试。然后适当增加或减小该因子，并再次运行性能测试。不断调整因子并运行性能测试，直到获得最优性能。以很小的增量逐渐增加或减小因子时，前几步中不会看到性能差异，然后会突然出现差异，最后再趋于稳定。

B.2.129 -xprefetch_auto_type=a

其中，a 是 [no%]indirect_array_access。

使用此选项可以确定编译器是否以为直接内存访问生成预取的方式为由选项 -xprefetch_level 指示的循环生成间接预取。

如果不指定 -xprefetch_auto_type 的设置，编译器会将其设置为 -xprefetch_auto_type=no%indirect_array_access。

类似 -xalias_level 的选项可以影响计算候选间接预取的主动性，进而影响因更好的内存别名歧义消除信息而发生的自动插入间接预取的主动性。

B.2.130 -xprefetch_level=l

(SPARC) 使用 -xprefetch_level 选项可以控制通过 -xprefetch=auto 确定的预取指令的自动插入的主动性。l 必须为 1、2 或 3。编译器更加主动，换句话说，引入了更多更高 -xprefetch_level 级别的预取。

-xprefetch_level 的适当值取决于应用程序可能具有的缓存缺失的数量。较高级别的 -xprefetch_level 值具有提高应用程序性能的潜能。

仅当使用 -xprefetch=auto 进行编译且优化级别为 3 或更高级别时此选项才有效，并可为支持预取（v8plus、v8plusa、 v9、v9a、v9b、generic64、 native64）的平台生成代码。

-xprefetch_level=1 启用预取指令的自动生成。-xprefetch_level=2 启用级别 1 以上的附加生成，-xprefetch_level=3 启用级别 2 以上的附加生成。

指定了 -xprefetch=auto 时，缺省值为 -xprefetch_level=1。

B.2.131 -xprofile=p

使用该选项收集并保存执行频率数据，从而可在以后的运行中使用该数据来提高性能。只有将优化指定为 -xO2 或更高级别时，该选项才有效。

必须在编译和链接时指定 -xprofile。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

通过为编译器提供运行时性能反馈可以增强在较高优化级别（例如，-xO5）进行的编译。为了生成运行时性能反馈，必须使用 -xprofile=collect 进行编译，然后对典型数据集运行可执行文件，最后在最高优化级别使用 -xprofile=use 重新编译。

对多线程应用程序来讲，配置文件集合是安全的。也就是说，对执行自身多任务 (-mt) 的程序进行文件配置会产生准确的结果。

p 必须为 collect[:name]、use[:name] 或 tcov。

• collect[:name]

  优化器使用 -xprofile=use 收集并保存执行频率数据以备将来使用。编译器生成可测量语句执行频率的代码。

  ---

  注 –

  在 Linux 上生成共享库时，请不要指定 -xprofile=collect。

  ---

  name 是所分析程序的名称。该名称是可选的。如果未指定 name，则假定 a.out 为可执行程序的名称。

  可以设置环境变量 SUN_PROFDATA 和 SUN_PROFDATA_DIR，以控制用 -xprofile=collect 编译的程序存储配置文件数据的位置。如果设置了这两个环境变量，则 -xprofile=collect 数据将写入到 SUN_PROFDATA_DIR/SUN_PROFDATA。

  这些环境变量同样控制 tcov 写入的配置文件数据文件的路径和名称，如 tcov(1) 手册页所述。

  如果未设置这些环境变量，配置文件数据将写入当前目录中的 name.profile/feedback，其中 name 是可执行文件的名称或在 -xprofile=collect:name 标志中指定的名称。如果 name 已在 .profile 中结束，-xprofile 将不向 name 追加 .profile。如果多次运行程序，那么执行频率数据会累积在 feedback 文件中；也就是说，以前执行的输出不会丢失。

  如果在不同的步骤中进行编译和链接，应确保使用 -xprofile=collect 编译的任何目标文件也使用 -xprofile=collect 进行链接。

• use[:name]

  使用在 feedback 文件中生成并保存在该文件中的执行频率数据来优化程序，该数据由先前执行使用 – xprofile=collect 编译的程序生成。

  name 是正在分析的程序的名称。该名称是可选的。如果未指定 name，则假定 a.out 为可执行程序的名称。

  除了从 -xprofile=collect 更改为 -xprofile=use 的 -xprofile 选项之外，源文件和其他编译器选项必须与用于编译的源文件和编译器选项完全相同，该编译创建了进而生成 feedback 文件的编译程序。用于收集生成和使用生成的编译器版本必须相同。如果使用 -xprofile=collect:name 进行编译，则相同的程序名称 name 必须出现在优化编译中：-xprofile=use:name。

  在使用 -xprofile=collect 编译目标文件时，目标文件及其配置文件数据之间的关联取决于目标文件的 UNIX 路径名。在某些情况下，编译器不会将目标文件与其配置文件数据相关联：由于以前没有使用 -xprofile=collect 编译目标文件，因此目标文件没有配置文件数据；程序中的目标文件未使用 -xprofile=collect 进行链接；从未执行过该程序。

  如果先前使用了 -xprofile=collect 在不同目录中编译目标文件，并且该目标文件与使用 -xprofile=collect 编译的其他目标文件共享公共基名，但却无法通过它们包含的目录名称进行唯一的标识，那么编译器也会发生混淆。在这种情况下，即使目标文件具有文件配置数据，使用 -xprofile=use 重新编译目标文件时，编译器也不能在反馈目录中找到该目标文件。

  所有这些情况都能使编译器丢失目标文件及其文件配置数据之间的关联。因此，在您指定 -xprofile=use 时，如果目标文件具有文件配置数据但编译器无法将其与目标文件的路径名相关联，那么请使用 -xprofile_pathmap 选项来标识正确的目录。请参见B.2.133 -xprofile_pathmap。

• tcov

  使用“新”样式 tcov 的基本块覆盖分析。

  -xprofile=tcov 选项是 tcov 的基本块文件配置的新样式。其功能与 -xa 选项相似，此外还能正确地为在头文件中具有源代码的程序收集数据。请参见B.2.66 -xa，以了解有关旧样式文件配置的信息；请参见 tcov(1) 手册页和 Program Performance Analysis Tools，以了解详细信息。

  执行代码检测与执行 -xa 选项相似，但是不再生成 .d 文件。相反却生成单一文件，并且该文件的名称是按照最后的可执行文件命名的。例如，如果程序在 /foo/bar/myprog.profile 外运行，则数据文件将存储在 /foo/bar/myprog.profile/myprog.tcovd 中。

  -xprofile=tcov 和 -xa 选项在单个可执行程序中兼容。也就是说，您可以链接一个程序，该程序中包含的部分文件已用 -xprofile=tcov 编译，而其他文件是用 -xa 编译的。您不能同时用这两个选项来编译一个文件。

  运行 tcov 时，您必须将 -x 选项传递给它，以使它使用新样式数据。否则，tcov 使用原来的 .d 文件（如果有；这是数据的缺省值），并产生不可预测的输出。

  与 -xa 选项不同，TCOVDIR 环境变量在编译时无效。不过，在程序运行时可以使用环境变量的值。有关详细信息，请参见 tcov(1) 和 Program Performance Analysis Tools。

  ---

  注 –

  如果由于 -xO4 或 -xinline 存在例程的内联处理，则 tcov 的代码覆盖报告可能不可靠。

  ---

当您使用 -xprofile=collect 来编译用于配置文件收集的程序，而用 -xprofile=use 来编译用于配置文件反馈的程序时，在这两个编译中，除 -xprofile=collect 和 -xprofile=use 之外的源文件和编译器选项必须相同。

-xprofile=use:name 选项指定的配置文件反馈目录名称从该选项在一次编译器调用中的所有实例中累积。例如，假定分别执行名称为 a、b 和 c 的已进行文件配置的二进制文件结果是创建文件配置目录 a.profile、b.profile 和 c.profile。

cc -O -c foo.c -xprofile=use:a -xprofile=use:b -xprofile=use:c
 

这三个配置文件目录均被使用。编译目标文件时，与特定目标文件有关的任何有效配置文件反馈数据都从指定的反馈目录中开始累积。

如果在同一的命令行上同时指定 -xprofile=collect和 -xprofile=use，则命令行中最右边 -xprofile 选项的应用如下所示：

• 如果最右边的 -xprofile 选项是 -xprofile=use，则 -xprofile=use 选项指定的所有配置文件反馈目录名都将用于定向反馈优化，同时忽略以前的 -xprofile=collect 选项。

• 如果最右边的 -xprofile 选项是 -xprofile=collect，则忽略 -xprofile=use 选项指定的所有配置文件反馈目录名，同时启用配置文件生成的检测。

另请参见：-xhwcprof、-xprofile_ircache、-xprofile_pathmap

B.2.132 -xprofile_ircache[= path]

(SPARC) 将 -xprofile_ircache[=path] 与 -xprofile=collect|use 一起使用，通过重用 collect 阶段保存的编译数据来缩短 use 阶段的编译时间。

在编译大程序时，由于中间数据的保存，使得 use 阶段的编译时间大大减少。注意，所保存的数据会占用相当大的磁盘空间。

在使用 -xprofile_ircache[=path] 时，path 会覆盖保存缓存文件的位置。缺省情况下，这些文件会作为目标文件保存在同一目录下。collect 和 use 阶段出现在两个不同目录中时，指定路径很有用。以下是典型的命令序列：

example% cc -xO5 -xprofile=collect -xprofile_ircache t1.c t2.c
example% a.out    // run collects feedback data
example% cc -xO5 -xprofile=use -xprofile_ircache t1.c t2.c

B.2.133 -xprofile_pathmap

(SPARC) 如果同时还指定 -xprofile=use 命令，请使用 -xprofile_pathmap=collect_prefix:use_prefix 选项。以下两个条件都成立且编译器无法找到使用 -xprofile=use 编译的目标文件的配置文件数据时，请使用 -xprofile_pathmap。

• 使用 -xprofile=use 编译目标文件所在的目录与先前使用 -xprofile=collect 编译目标文件所在的目录不同。

• 目标文件会共享配置文件中的公共基名，但可以根据它们在不同目录中的位置互相区分。

collect-prefix 是目录树的 UNIX 路径名的前缀，在该目录树中使用 -xprofile=collect 编译目标文件。

use-prefix 是目录树的 UNIX 路径名的前缀，在该目录树中使用 -xprofile=use 编译目标文件。

如果指定了 -xprofile_pathmap 的多个实例，编译器将按照这些实例的出现顺序对其进行处理。将 -xprofile_pathmap 实例指定的每个 use-prefix 与目标文件路径名进行比较，直至找到匹配的 use-prefix 或发现最后一个指定的 use-prefix 与目标文件路径名也不匹配。

B.2.134 -xreduction

(SPARC) 在自动并行化期间打开约简识别。-xreduction 必须用 -xautopar 或 -xparallel 指定，否则编译器将发出警告。

当启用约简识别时，编译器并行化约简，例如 dot 产品、最大与最小查找。这些约简产生的舍入与通过非并行化代码获得的舍入不同。

B.2.135 -xregs=r[, r…]

为生成的代码指定寄存器用法。

r 是一个逗号分隔列表，它包含以下项中的一项或多项：[no%]appl、[no%]float、[no%]frameptr。

示例：-xregs=appl,no%float

SPARC 缺省值为 -xregs=appl,float。

x86 缺省值为 -xregs=no%frameptr。-xregs=frameptr 包含在 -fast 的扩展中。

强烈推荐您用 -xregs=no%appl,float 编译那些用于与应用程序链接的共享库的代码。至少共享库应该显式说明它如何使用应用程序寄存器，以便与这些库链接的应用程序知道如何处理该问题。

例如，在某种全局意义上使用寄存器（例如，使用寄存器指向一些关键数据结构）的应用程序，需要确切地知道其代码未使用 -xregs=no%appl 编译的某个库如何使用应用程序寄存器，以便安全地与该库链接。

B.2.136 -xrestrict[= f]

(SPARC) 将返回赋值指针函数参数视为限定的指针。f 为 %all、%none，或由下面的一个或多个函数名构成的逗号分隔列表：{%all|%none|fn[,fn...]}。

如果使用该选项指定函数列表，则指定的函数中的指针参数将被视为限定的；如果指定 -xrestrict=%all，则整个 C 文件中的所有指针参数均被视为限定的。有关更多信息，请参阅3.8.2 限定指针。

此命令行选项可以单独使用，但最好将其用于优化。例如，命令：

%cc -xO3 -xrestrict=%all prog.c

将文件 prog.c 中的所有指针参数都视为限定指针。命令：

%cc -xO3 -xrestrict=agc prog.c

将文件 prog.c 中函数 agc 中的所有指针参数都视为限定指针。

缺省值为 %none；指定 -xrestrict 与指定 -xrestrict=%all 等效。

B.2.137 -xs

允许在不使用目标文件的情况下由 dbx 进行调试。

该选项导致所有调试信息被复制到可执行程序中。这对 dbx 的性能或程序的运行时性能几乎没有什么影响，但需要更多磁盘空间。

B.2.138 -xsafe=mem

(SPARC) 允许编译器假定没有内存保护违规发生。

该选项允许在 SPARC V9 体系结构中使用无故障装入指令。

因为错误（如地址未对齐或段违规）发生时无故障装入不产生自陷，所以该选项只能用于不发生这些错误的程序。因为很少有程序会导致基于内存的自陷，所以可以安全地将该选项用于大多数程序。对于显式依赖基于内存的自陷来处理异常情况的程序，请勿使用该选项。

仅当使用优化级别 -xO5 以及下列 -xarch 值之一时，该选项才有效：sparc、sparcvis 或 sparcvis2（对于 -m32 和 -m64 而言）。

B.2.139 -xsb

使用此选项可为源代码浏览器生成额外的符号表信息。该选项在编译器的 –Xs 模式下无效。

如果要在单独的步骤中进行编译和链接，请务必在编译步骤和链接步骤中都指定 -xsb，否则将显示来自链接程序的错误消息。有关在编译时和链接时都必须指定的所有编译器选项的完整列表，请参见表 A–2。

如果未使用 -xsb 来链接使用 -xsb 编译的对象，则会将源代码浏览器数据限制于那些在链接步骤中创建的可执行程序所使用的引用。另外，如果未在单独的编译和链接步骤中指定 -xsb，则可能会丢失源代码浏览器数据库中的一些符号引用。

通过在编译步骤和链接步骤中包括 -xsb，当对象在相同目录中用不同的方法编译并与不同的可执行程序链接时，您可以确保这两个对象中的所有符号引用对源代码浏览器是可见的。

B.2.140 -xsbfast

为源代码浏览器创建数据库。不会将源代码编译到目标文件中。该选项在编译器的 –Xs 模式下无效。

B.2.141 -xsfpconst

将无后缀的浮点常量表示为单精度模式，而非缺省的双精度模式。与 -Xc 一起使用时无效。

B.2.142 -xspace

不执行可增加代码大小的循环优化或并行化。

示例：如果编译器增加代码大小，它不会解开循环或并行化循环。

B.2.143 -xstrconst

将串文字插入文本段而非缺省数据段的只读数据节中。删除重复的字符串并在代码的引用间共享剩余副本。

B.2.144 -xtarget=t

为指令集和优化指定目标系统。

t 的值必须是下列值之一：native、generic、native64、generic64、system-name。

-xtarget 的每个特定值都会扩展到 -xarch、-xchip 和 -xcache 选项值的特定集合。使用 -xdryrun 选项可在运行的系统上确定 -xtarget=native 的扩展。

例如，-xtarget=sun4/15 与以下内容等效：-xarch=v8a -xchip=micro -xcache=2/16/1。

在特定主机平台上编译时，该平台的 -xtarget 扩展可能无法扩展到与 -xtarget=native 相同的 -xarch、-xchip 或 -xcache 设置。

通过为编译器提供目标计算机硬件的精确描述，某些程序的性能可得到提高。当程序性能很重要时，目标硬件的正确指定是非常重要的。在较新的 SPARC 处理器上运行时，尤其是这样。不过，对大多数程序和较旧的 SPARC 处理器来讲，性能的提高微不足道，因此指定 generic 就足够了。

B.2.144.1 SPARC 平台的 -xtarget 值

使用 -m64 选项可指示在 SPARC 或 UltraSPARC V9 上编译 64 位 Solaris 软件。如果指定带有除 native64 或 generic64 以外的标志的 -xtarget，则还必须按如下方式指定 -m64 选项：-xtarget=ultra... -m64，否则编译器将使用 32 位内存模型。

B.2.144.2 x86 平台的 -xtarget 值

使用 -m64 选项可指示在 64 位 x86 平台上编译 64 位 Solaris 软件。如果指定带有除 native64 或 generic64 以外的标志的 -xtarget，则还必须按如下方式指定 -m64 选项：-xtarget=opteron ... -m64，否则编译器将使用 32 位内存模型。

B.2.145 -xtemp=dir

将 cc 使用的临时文件的目录设置为 dir。在此选项字符串中不允许有空格。如果没有此选项，临时文件将进入 /tmp。-xtemp 优先于 TMPDIR 环境变量。

B.2.146 -xthreadvar[= o]

指定 -xthreadvar 来控制线程局部变量的实现。将此选项与 __thread 声明说明符结合使用，可利用编译器的线程局部存储功能。用 __thread 说明符声明线程变量之后，请指定 -xthreadvar 启用具有动态（共享）库中与位置无关代码（非 PIC 代码）的线程局部存储。有关如何使用 __thread 的更多信息，请参见2.3 线程局部存储说明符。

o 必须为下列值之一：

如果未指定 -xthreadvar，编译器所用的缺省设置取决于是否启用与位置无关的代码。如果启用了与位置无关的代码，则该选项设置为 -xthreadvar=dynamic。如果禁用了与位置无关的代码，则该选项设置为 -xthreadvar=no%dynamic。

如果指定 -xthreadvar，但未指定任何值，则该选项设置为 -xthreadvar=dynamic。

如果动态库中存在与位置有关的代码，那么就必须指定 -xthreadvar。

链接程序不支持在动态库中与非 PIC 代码等效的线程变量。由于非 PIC 线程变量要快很多，所以应将其用作可执行文件的缺省设置。

在 Solaris 软件的不同版本上使用线程变量需要在命令行中使用不同选项。

• 在 Solaris 8 软件中，使用 __thread 的对象必须使用 -mt 来编译，而且必须使用 -mt -L/usr/lib/lwp -R/usr/lib/lwp 进行链接。

• 在 Solaris 9 软件中，使用 __thread 的对象必须使用 -mt 来编译和链接。

另请参见：-xcode、-KPIC、-Kpic

B.2.147 -xtime

报告每个编译组件所用的时间和资源。

B.2.148 -xtransition

针对 K&R C 与 Sun ISO C 之间的差异发出警告。

-xtransition 选项与 -Xa 和 -Xt 选项一起使用时将发出警告。通过适当编码，可以消除关于不同行为的所有警告消息。除非使用 -xtransition 选项，否则不再出现以下警告：

• \a is ISO C “alert” character

• \x is ISO C hex escape

• bad octal digit

• base type is really type tag: name

• comment is replaced by “##”

• comment does not concatenate tokens

• declaration introduces new type in ISO C: type tag

• macro replacement within a character constant

• macro replacement within a string literal

• no macro replacement within a character constant

• no macro replacement within a string literal

• operand treated as unsigned

• trigraph sequence replaced

• ISO C treats constant as unsigned: operator

• semantics of operator change in ISO C; use explicit cast