附录 A C++ 编译器选项

本附录详细介绍了 C++ 编译器的命令行选项。介绍的功能适用于除了特别注明之外的所有平台；基于 SPARC 的系统上的 Solaris OS 特有的功能标识为 SPARC，基于 x86 的系统上的 Solaris 和 Linux OS 特有的功能标识为 x86。仅限于 Solaris OS 的功能标记了 Solaris；仅限于 Linux OS 的功能标记了 Linux。请注意，提及 Solaris OS 时也意指 OpenSolaris OS。

本手册的此部分使用前言中列出的印刷约定来说明各个选项。

圆括号、大括号、方括号、"|" 或 "-" 字符以及省略号是选项说明中使用的元字符，而不是选项自身的一部分。

A.1 选项信息的结构

为了帮助您查找信息，编译器选项说明被分为以下几个子节。如果一个选项被其他选项取代或与其他选项一致，就请参阅其他选项的说明以获取完整的详细信息。

A.2 选项参考

本节按字母顺序列出所有的 C++ 编译器选项，并指出所有的平台限制。

A.2.1 –386

x86： 与 –xtarget=386 相同。提供该选项只是为了向后兼容。

A.2.2 –486

x86： 与 –xtarget=486 相同。提供该选项只是为了向后兼容。

A.2.3 –a

与 –xa 相同。

A.2.4 –Bbinding

指定 链接的库绑定是symbolic、dynamic（共享）还是 static（非共享）。

可以在命令行上多次使用 –B 选项。该选项传递给链接程序 ld。

在 Solaris 64 位编译环境中，许多系统库只能用作动态库。因此，请勿在命令行上将 -Bstatic 用作最后一个切换开关。

A.2.4.1 值

binding 必须是下列值之一：

（–B 和 binding 值之间不能有空格。）

缺省值

如果没有指定 -B，则使用 –Bdynamic。

交互

要静态链接 C++ 缺省库，请使用 –staticlib 选项。

-Bstatic 和 -Bdynamic 选项会影响缺省情况下提供的库的链接。为了确保动态链接缺省库，最后使用的 –B 应该是 –Bdynamic。

在 64 位环境中，许多系统库只能用作共享动态库。其中包括 libm.so 和 libc.so（不提供 libm.a 和 libc.a）。因此，在 64 位 Solaris 操作系统中，-Bstatic 和 -dn 可能会导致产生链接错误。这些情况下应用程序必须与动态库链接。

示例

以下编译器命令链接 libfoo.a，即使 libfoo.so 存在也是如此，所有其他库都是动态链接的：

example% CC a.o –Bstatic –lfoo –Bdynamic

警告

对于包含 C++ 代码的程序，切勿使用 -Bsymbolic，而应使用链接程序映射文件。

如果使用 -Bsymbolic，不同模块中的引用会绑定到应是一个全局对象内容的不同副本。

异常机制依赖对地址的比较。如果您具有某项内容的两个副本，它们的地址就不等同且异常机制可能失败，这是由于异常机制依赖对假设为唯一地址内容的比较。

如果在不同的步骤中进行编译和链接，并要使用 -Bbinding 选项，就必须在链接步骤中包括该选项。

另请参见

–nolib、–staticlib、ld(1)、12.5 静态链接标准库和《链接程序和库指南》

A.2.5 –c

仅编译；生成 .o 目标文件，但抑制链接。

该选项指示 CC 驱动程序抑制通过 ld 进行链接，并为每个源文件生成一个 .o 文件。如果只在命令行上指定一个源文件，就可以用 -o 选项显式指定目标文件。

A.2.5.1 示例

如果输入 CC -c x.cc，则会生成 x.o 目标文件。

如果输入 CC -c x.cc -o y.o，则会生成 y.o 目标文件。

警告

当编译器为输入文件 (.c、.i) 生成目标代码时，编译器总是在工作目录下生成 .o 文件。如果抑制链接步骤，则不会删除 .o 文件。

另请参见

–o filename 和 –xe

A.2.6 –cg{89|92}

与 –xcg{89|92} 相同。

A.2.7 –compat[={4|5}]

设置编译器的主要发行版兼容模式。此选项控制 __SUNPRO_CC_COMPAT 和 __cplusplus 宏。

C++ 编译器有两个主要模式。兼容模式接受 4.2 编译器所定义的 ARM 语义和语言。标准模式接受符合 ANSI/ISO 标准的构造。由于 ANSI/ISO 标准在名称损坏、虚函数表布局和其他 ABI 详细信息中强制进行显著的不兼容的更改，所以这两个模式是互相不兼容的。这两个模式由 –compat 选项进行区分，下文中介绍了相应值。

A.2.7.1 值

-compat 选项可以有下列值。

缺省值

如果没有指定 –compat 选项，则假定 –compat=5。

如果仅指定 –compat，则假定 –compat=4。

交互

在兼容模式 (-compat[=4]) 下，不能使用标准库。

–compat[=4] 不能与下列任何选项一起使用。

• -Bsymbolic

• -features=[no%]strictdestrorder

• -features=[no%]tmplife

• -library=[no%]iostream

• -library=[no%]Cstd

• -library=[no%]Crun

• -library=[no%]rwtools7_std

• -xarch=native64、-xarch=generic64、-xarch=v9、-xarch=v9a 或 -xarch=v9b

–compat=5 不能与下列任何选项一起使用。

• -Bsymbolic

• +e

• features=[no%]arraynew

• features=[no%]explicit

• features=[no%]namespace

• features=[no%]rtti

• library=[no%]complex

• library=[no%]libC

• -vdelx

警告

生成共享库时，不要使用 -Bsymbolic。

另请参见

《C++ 迁移指南》

A.2.8 +d

请勿扩展 C++ 内联函数。

按照 C++ 语言规则，C++ 内联函数是一个函数，对于该函数以下语句之一为真。

• 该函数的定义中使用了关键字 inline

• 该函数在类定义内部定义（不仅是声明）

• 该函数是编译器生成的类成员函数

按照 C++ 语言规则，编译器可以选择是否将调用实际内联到内联函数。C++ 编译器将调用内联到内联函数，除非：

• 函数过于复杂

• 已选定 +d 选项

• 已选定 -g 选项

A.2.8.1 示例

缺省情况下，编译器可以内联以下代码示例中的函数 f() 和 memf2()。此外，该类具有编译器可以内联的由编译器生成的缺省构造函数和析构函数。使用 +d 时，编译器不会内联 f() 和 C::mf2()（即构造函数和析构函数）。

inline int f() {return 0;} // may be inlined
class C {
  int mf1(); // not inlined unless inline definition comes later
  int mf2() {return 0;} // may be inlined
};

交互

指定了调试选项 –g 时，会自动启用该选项。

但指定调试选项 –g0 不会启用 +d。

+d 选项对使用 -xO4 或 -xO5 时执行的自动内联没有影响。

另请参见

–g0 和 –g

A.2.9 -Dname[ =def]

为预处理程序定义宏符号 name。

使用该选项与在源文件开头包含 #define 指令等效。可以使用多个 -D 选项。

A.2.9.1 值

下表显示了预定义的宏。可以在诸如 #ifdef 之类的预处理程序条件下使用这些值。

__`uname -s`_`uname -r | tr . _`

如果不使用 =def，则 name 定义为 1。

交互

如果使用 +p，则不会定义 sun、unix、sparc 和 i386。

另请参见

–U

A.2.10 –d{y|n}

允许或不允许将动态库用于整个可执行文件。

该选项传递给 ld。

该选项只能在命令行出现一次。

A.2.10.1 值

缺省值

如果没有指定 -d 选项，则使用 –dy。

交互

在 64 位环境中，许多系统库只能用作共享动态库。其中包括 libm.so 和 libc.so（不提供 libm.a 和 libc.a）。因此，在 64 位 Solaris 操作系统中，-Bstatic 和 -dn 可能会导致产生链接错误。这些情况下应用程序必须与动态库链接。

警告

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

另请参见

ld(1) 和《链接程序和库指南》。

A.2.11 –dalign

(SPARC) -dalign 与 -xmemalign=8s 等效。有关更多信息，请参见A.2.151 -xmemalign=ab。

在 x86 平台上，默认忽略此选项。

A.2.11.1 警告

如果使用 –dalign 编译一个程序单元，就要使用 -dalign 编译程序的所有单元，否则可能会产生意外的结果。

A.2.12 –dryrun

显示但不编译驱动程序所生成的子命令。

该选项指示驱动程序 CC 显示但不执行编译驱动程序构造的子命令。

A.2.13 –E

对源文件运行预处理程序，但不进行编译。

指示 CC 驱动程序仅对 C++ 源文件运行预处理程序，并将结果发送到 stdout（标准输出）。此时，不进行编译，且不生成 .o 文件。

此选项会导致输出中包含预处理程序类型的行号信息。

A.2.13.1 示例

该选项用于确定预处理程序所进行的更改。例如，以下程序 foo.cc 会生成A.2.13.1 示例中所示的输出。

示例 A–1 预处理程序示例 foo.cc

#if __cplusplus < 199711L
int power(int, int);
#else
template <> int power(int, int);
#endif

int main () {
  int x;
  x=power(2, 10);
}
.

示例 A–2 使用 -E 选项时 foo.cc 的预处理程序输出

example% CC -E foo.cc
#4 "foo.cc"
template < > int power (int, int);


int main () {
int x;
x = power (2, 10);
}

警告

如果代码包含采用“独立定义”模型的模板，此选项的输出可能不能用作 C++ 编译的输入。

另请参见

–P

A.2.14 +e{0|1}

控制兼容模式 (-compat[=4]) 下虚拟表的生成。在标准模式下（缺省模式）无效并被忽略。

A.2.14.1 值

+e 选项可以有下列值。

交互

使用该选项进行编译时，也可以使用 –features=no%except 选项。否则，编译器会为用于异常处理的内部类型生成虚拟表。

如果模板类具有虚函数，就可能无法确保编译器生成全部所需的虚拟表而不复制这些表。

另请参见

《C++ 迁移指南》

A.2.15 -erroff[= t]

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

A.2.15.1 值

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

缺省值

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

示例

例如，-erroff=tag 将抑制由该标记指定的警告消息。另外，-erroff=%all,no%tag 抑制除由 tag 标识的消息以外的所有警告消息。

可以使用 -errtags=yes 选项显示警告消息的标记。

警告

使用 -erroff 选项只能抑制来自 C++ 编译器前端且在使用 -errtags 选项时显示标记的警告消息。

另请参见

-errtags 和 -errwarn。

A.2.16 -errtags[= a]

显示来自 C++ 编译器前端且可以使用 -erroff 选项抑制或使用 -errwarn 选项使其成为致命警告的每个警告消息的消息标记。

A.2.16.1 值和缺省

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

警告

来自 C++ 编译器驱动程序和编译系统其他组件的消息没有错误标记，因此不能使用 -erroff 抑制，也不能使用 -errwarn 使其成为致命消息。

另请参见

-erroff 和 -errwarn

A.2.17 -errwarn[= t]

使用 -errwarn 会导致 C++ 编译器在出现给定的警告消息时以失败状态退出。

A.2.17.1 值

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

下表详细列出了 -errwarn 值：

缺省值

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

警告

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

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

另请参见

-erroff、-errtags 和 -xwe

A.2.18 –fast

此选项是一个宏，可以有效地用作优化可执行文件的起点，从而获得最佳运行时性能。-fast 是一个宏，随编译器发行版本的升级而变化，并扩展为目标平台特定的多个选项。可使用 -dryrun 或 -xdryrun 选项检查 -fast 的扩展，并将 -fast 的相应选项结合到正在进行的可执行文件调优过程中。

该选项是一个宏，选择编译选项的组合用于在编译代码的机器上优化执行速度。

A.2.18.1 扩展

该选项通过扩展到以下编译选项，为大量应用程序提供了几乎最高的性能。

交互

-fast 宏可扩展为可能影响其他指定选项的编译选项。例如，在以下命令中，-fast 宏的扩展包括了将 -xarch 还原为某个 32 位体系结构选项的 -xtarget=native。

错误：

example% CC -xarch=v9 -fast test.cc

正确：

example% CC -fast -xarch=v9 test.cc

查看每个选项的描述以确定可能的交互操作。

代码生成选项、优化级别、内建函数的优化和内联模板文件的使用可以用后续选项来覆盖（请参阅示例）。指定的优化级别将覆盖以前所设置的优化级别。

–fast 选项包括 –fns–ftrap=%none，即该选项禁用所有陷阱操作。

示例

执行以下编译器命令，优化级别将为 –xO3。

example% CC –fast –xO3

执行以下编译器命令，优化级别将为 –xO5。

example% CC -xO3 –fast

警告

如果在不同的步骤中进行编译和链接，则编译命令和链接命令中都必须有 -fast 选项。

使用 -fast 选项编译的目标二进制文件不可移植。例如，在 UltraSPARCIII 系统中用以下命令生成的二进制文件在 UltraSPARCII 系统中无法执行。

example% CC -fast test.cc

不要将该选项用于依赖 IEEE 标准浮点运算的程序，否则可能会产生不同的数字结果、过早的程序终止或意外的 SIGFPE 信号。

在早期的 SPARC 发行版中，-fast 宏扩展到了 -fsimple=1。而现在扩展到 -fsimple=2。

-fast 的扩展包括 -D_MATHERR_ERRNO_DONTCARE。

要在任何平台上显示 —fast 的扩展，请运行命令 CC —dryrun —fast。

>CC -dryrun -fast
###     command line files and options (expanded):
### -dryrun -xO5 -xarch=sparcvis2 -xcache=64/32/4:1024/64/4 \
-xchip=ultra3i -xmemalign=8s -fsimple=2 -fns=yes -ftrap=%none \
-xlibmil -xlibmopt -xbuiltin=%all -D__MATHERR_ERRNO_DONTCARE

另请参见

-fns、-fsimple、-ftrap=%none、-xlibmil、-nofstore、-xO5、-xlibmopt 和 -xtarget=native

A.2.19 –features=a[,a...]

启用/禁用逗号分隔的列表中指定的各种 C++ 语言功能。

A.2.19.1 值

在兼容模式 (-compat[=4]) 和标准模式（缺省模式）下，a 都可以具有以下值：

在标准模式（缺省模式）下，a 可以有下列其他值：

在兼容模式 (-compat[=4]) 下，a 可以有下列其他值。

允许使用 [no%]castop 设置，以便与针对 C++ 4.2 编译器编写的 makefile 兼容，但对更高的编译器版本没有影响。新式强制类型转换（const_cast、dynamic_cast、reinterpret_cast 和 static_cast）总是会被识别且无法禁用。

缺省值

如果未指定 –features，兼容模式 (-compat[=4]) 下的缺省值为：

–features=%none,anachronisms,except,split_init,transitions

在缺省的“标准模式”下，假定采用

-features=%all,no%extensions,no%iddollar,no%tmplrefstatic

交互

该选项会累积而不覆盖。

在标准模式（缺省）中以下选项与标准库和头文件不兼容：

• no%bool

• no%except

• no%mutable

• no%explicit

在兼容模式 (-compat[=4]) 下，-features=transitions 选项不起作用，除非指定了 +w 选项或 +w2 选项。

警告

指定 -features=%all 或 -features=%none 时务必谨慎。features 的设置可能会随每个编译器发行版和补丁程序而发生变化。从而可能会有一些您不希望获得的程序行为发生。

使用 -features=tmplife 选项时，程序的行为可能会发生变化。测试在使用与不使用 -features=tmplife 选项两种情况下程序是否正常运行是一种测试程序可移植性的方法。

在兼容模式 (-compt=4) 下，编译器会在缺省情况下假定 -features=split_init。如果使用 -features=%none 选项禁用其他功能，就会发现需要改用 -features=%none,split_init 重新将初始化函数分到单独的函数中。

另请参见

表 3–17 和《C++ 迁移指南》

A.2.20 -filt[=filter[,filter...]]

控制编译器通常应用于链接程序和编译器错误消息的过滤功能。

A.2.20.1 值

filter 必须是下列值之一。

缺省值

如果未指定 -filt 选项或指定了 -filt 但未提供任何值，则编译器假定 -filt=%all。

示例

以下示例显示了使用 -filt 选项编译该代码的效果。

// filt_demo.cc
class type {
public:
    virtual ~type(); // no definition provided
};

int main()
{
    type t;
}

如果编译代码时不使用 -filt 选项，编译器就假定 -filt=errors,names,returns,stdlib 并显示标准输出。

example% CC filt_demo.cc
Undefined             first referenced
 symbol                  in file
type::~type()         filt_demo.o
type::__vtbl          filt_demo.o
[Hint: try checking whether the first non-inlined, /
non-pure virtual function of class type is defined]

ld: fatal: Symbol referencing errors. No output written to a.out

以下命令禁止还原 C++ 损坏链接程序名称，并禁止链接程序错误的 C++ 解释。

example% CC -filt=no%names,no%errors filt_demo.cc
Undefined                       first referenced
 symbol                             in file
__1cEtype2T6M_v_                    filt_demo.o
__1cEtypeG__vtbl_                   filt_demo.o
ld: fatal: Symbol referencing errors. No output written to a.out

现在考虑以下代码：

#include <string>
#include <list>
int main()
{
    std::list<int> l;
    std::string s(l); // error here
}

下面是指定了 -filt=no%stdlib 时的输出：

Error: Cannot use std::list<int, std::allocator<int>> to initialize
std::basic_string<char, std::char_traits<char>,
std::allocator<char>>.

下面是指定了 -filt=stdlib 时的输出：

Error: Cannot use std::list<int> to initialize std::string .

交互

指定了 no%names 时，returns 和 no%returns 都无效。也就是说，以下选项是相同的：

• -filt=no%names

• -filt=no%names,no%returns

• -filt=no%names,returns

A.2.21 –flags

与 – xhelp=flags 相同。

A.2.22 -fma[={none|fused}]

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

缺省值是 -fma=none。

要使编译器生成乘加指令，最低要求是 -xarch=sparcfmaf 且优先级别至少为 -xO2。如果生成了乘加指令，编译器会标记此二进制程序，以防止该程序在不受支持的平台上执行。

乘加指令会消除乘与加之间的中间舍入步骤。因此，使用 -fma=fused 编译时程序可能会产生不同的结果，尽管精度是趋于提高而不是降低。

A.2.23 –fnonstd

使硬件自陷可用于浮点溢出，除以零，并可用于无效运算异常。产生的结果被转换为 SIGFPE 信号，如果程序没有 SIGFPE 处理程序，它就会终止并转储内存（除非将核心转储大小限制到零）。

SPARC： 此外，-fnonstd 还选择 SPARC 非标准浮点。

A.2.23.1 缺省值

如果未指定 –fnonstd，则 IEEE 754 浮点算术异常不会中止程序，而是出现逐渐下溢情况。

扩展

x86： -fnonstd 扩展到 -ftrap=common。

SPARC： -fnonstd 扩展到 -fns ftrap=common。

另请参见

–fns、–ftrap=common 和《数值计算指南》。

A.2.24 –fns[={yes|no}]

• SPARC： 启用/禁用 SPARC 的非标准浮点模式。

  如果使用 -fns=yes（或 -fns），则会在程序开始执行时启用非标准浮点模式。

  该选项提供了一种切换使用非标准浮点模式或标准浮点模式的方法，它接在包括 –fns 的其他某些宏选项（如 –fast）后面。

  在某些 SPARC 设备上，非标准浮点模式会禁用“逐渐下溢”，这会导致很小的结果刷新为零而不是生成次正规数，此外，还会导致次正规操作数在无提示的情况下替换为零。

  对于那些硬件中不支持逐渐下溢和次正规数的 SPARC 设备，-fns=yes（或 -fns）可以显著提高某些程序的性能。

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

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

  此选项对不使用 SSE 或 SSE2 指令集的传统 x86 浮点运算没有影响。

A.2.24.1 值

-fns 选项可以有下列值。

缺省值

如果未指定 -fns，则不自动启用非标准浮点模式。进行标准 IEEE 754 浮点计算（即逐渐下溢）。

如果仅指定了 –fns，则假定 –fns=yes。

示例

在以下示例中，-fast 扩展为多个选项，其中一个是 -fns=yes，即选择非标准浮点模式。后续 -fns=no 选项覆盖初始设置，并选择浮点模式。

example% CC foo.cc -fast -fns=no

警告

非标准模式启动时，浮点运算可以产生不符合 IEEE 754 标准要求的结果。

如果使用 -fns 选项编译一个例程，就要使用 –fns 选项编译该程序的所有例程，否则就会产生意外的结果。

该选项仅在 SPARC 设备上有效，并且仅在编译主程序时才能有效使用。在 x86 设备上，此选项被忽略。

使用 –fns=yes（或 -fns）选项时，如果程序中出现通常由 IEEE 浮点陷阱处理程序管理的浮点错误，则可能会生成以下消息：

另请参见

《数值计算指南》和 ieee_sun(3M)。

A.2.25 –fprecision=p

x86： 设置非缺省浮点精度模式。

–fprecision 选项用于设置浮点控制字中的舍入精度模式位。这些位控制基本算术运算（加、减、乘、除和平方根）结果的舍入精度。

A.2.25.1 值

p 必须是下列值之一。

如果 p 为 single 或 double，该选项会使舍入精度模式在程序开始执行时分别设置为 single 或 double 精度。如果 p 是 extended 或未使用 –fprecision 选项，则舍入精度模式保持为 extended 精度。

在 single 精度舍入模式下，结果将舍入到 24 个有效位；在 double 精度舍入模式下，结果将舍入到 53 个有效位。在缺省的 extended 精度模式下，结果将舍入到 64 个有效位。该模式只控制在寄存器中结果的舍入精度，而不影响范围。寄存器中所有的结果都使用了各种已扩展的双精度格式来舍入。不过，存储在内存中的结果既舍入到目标格式的范围也舍入到目标格式的精度。

float 类型的标称精度为 single。long double 类型的标称精度为 extended。

缺省值

如果未指定 –fprecision 选项，舍入精度模式缺省为 extended。

警告

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

A.2.26 –fround=r

启动时设置有效的 IEEE 舍入模式。

该选项将 IEEE 754 舍入模式设置为：

• 编译器可以将其用于计算常量表达式

• 程序初始化期间在运行时建立

含义与 ieee_flags 子例程的含义相同，可用于更改运行时的模式。

A.2.26.1 值

r 必须是下列值之一。

缺省值

如果未指定 –fround 选项，舍入模式缺省为 -fround=nearest。

警告

如果使用 –fround=r 编译一个例程，就要使用相同的 –fround=r 选项编译程序的所有例程，否则可能会产生意外的结果。

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

A.2.27 –fsimple[=n]

选择浮点优化首选项。

该选项允许优化器简化关于浮点运算的假定。

A.2.27.1 值

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

缺省值

如果未指定 –fsimple，编译器将使用 -fsimple=0。

如果指定了 -fsimple 但未指定 n 值，编译器将使用 -fsimple=1。

交互

-fast 隐含了 – fsimple=2。

警告

该选项可以破坏 IEEE 754 的一致性。

另请参见

-fast

Rajat Garg 和 Ilya Sharapov 合著的《Techniques for Optimizing Applications: High Performance Computing》，该书详细介绍了优化对精度的影响。

A.2.28 –fstore

x86：

强制浮点表达式的精度。

在以下值为真时，该选项使编译器将浮点表达式或函数的值转换为赋值左侧的类型，而不是将该值保留在寄存器中：

• 将表达式或函数分配到变量。

• 表达式被强制转换为较短的浮点类型。

要禁用此选项，请使用 –nofstore 选项。

A.2.28.1 警告

由于误差和截断，结果可能会与寄存器值所生成的结果不同。

另请参见

–nofstore

A.2.29 –ftrap=t[,t...]

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

A.2.29.1 值

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。

另请参见

ieee_handler(3M) 和 fex_set_handling(3M) 手册页。

A.2.30 –G

生成动态共享库而不是可执行文件。

缺省情况下，在命令行上指定的所有资源文件都是使用 -xcode=pic13 进行编译的。

生成使用模板的共享库时，多数情况下有必要将这些模板函数包括在共享库中，而这些函数已在模板数据库中实例化。使用该选项可以将这些模板自动增加到所需的共享库中。

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

创建共享对象时，所有使用 -xarch=v9 编译的目标文件也必须使用 A.2.119 –xcode=a 中推荐的显式 -xcode 值进行编译。

A.2.30.1 交互

如果未指定 – c（仅编译选项），以下选项将传递给链接程序：

• –dy

• –G

• –R

警告

请勿使用 ld-G 生成共享库，而应使用 CC- G。CC 驱动程序会自动将 C++ 所需的多个选项传递给 ld。

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

另请参见

-dy、-Kpic、-xcode=pic13、–ztext、ld(1) 手册页以及16.3 生成动态（共享）库。

A.2.31 –g

生成附加的符号表信息，以供使用 dbx(1) 或调试器进行调试以及使用性能分析器 analyzer(1) 进行分析。

指示编译器和链接程序准备进行调试和性能分析的文件或程序。

其任务包括：

• 生成以目标文件和可执行文件的符号表形式表示的详细信息（称为 stabs）。

• 生成某些“帮助应用程序函数”，调试器可以调用这些函数来实现其某些功能。

• 禁用函数的内联生成。

• 禁用优化的某些级别。

A.2.31.1 交互

如果将此选项与 –xOlevel（或其等效选项，如 -O）一起使用，将会获得一些特定的调试信息。有关更多信息，请参见 A.2.157 -xOlevel。

如果使用该选项且优化级别为 -xO4 或更高，编译器会为完全优化提供尽可能多的符号信息。

指定此选项时，除非还指定 -O 或 -xO，否则会自动指定 +d 选项。

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

要使用性能分析器的完整功能，请使用 -g 选项进行编译。尽管一些性能分析功能不要求使用 -g，但是必须使用 -g 进行编译才能查看带注释的源代码、一些函数级信息和编译器注释性消息。有关更多信息，请参阅 analyzer(1) 手册页和《程序性能分析工具》中的“编译您的程序以进行数据收集和分析”。

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

警告

如果在不同的步骤中编译和链接程序，则在一个步骤中使用 -g 选项而在另一个步骤中不使用该选项不会影响程序的正确性，但会影响调试程序的能力。没有使用 -g（或 -g0）编译但使用 -g（或 -g0）链接的任何模块将不能正常进行调试。请注意，通常必须使用 -g 选项（或 -g0 选项）编译包含函数 main 的模块才能对其进行调试。

另请参见

+d、–g0、–xs、analyzer(1) 手册页、er_src(1) 手册页、ld(1) 手册页、《使用 dbx 调试程序》（介绍了有关 stabs 的详细信息）和《程序性能分析工具》。

A.2.32 –g0

编译和链接以便进行调试，但不禁用内联。

此选项与 –g 相同，但 +d 处于禁用状态，dbx 无法步入内联函数。

如果指定 -g0 且优化级别为 -xO3 或更低，编译器会为近乎完全优化提供尽可能多的符号信息。尾部调用优化和后端内联被禁用。

A.2.32.1 另请参见

+d、–g 和《使用 dbx 调试程序》

A.2.33 –H

打印所包含文件的路径名。

在标准错误输出 (stderr) 中，该选项打印当前编译中包含的每个 #include 文件的路径名（每行一个）。

A.2.34 –h[ ]name

为生成的动态共享库指定名称 name。

这是一个链接程序选项，传递给 ld。通常，-h 后面的名称应该与 –o 后面的名称完全相同。–h 和 name 之间的空格是可选的。

编译时的加载器将指定名称分配到正在创建的共享动态库中，并将该名称作为库的内部名称记录在库文件中。如果没有 –hname 选项，则没有内部名称记录在库文件中。

每个可执行文件都具有所需的共享库文件列表。当运行时链接程序将库链接到可执行文件中时，链接程序将内部名称从库复制到所需共享库文件的列表中。如果没有共享文件的内部名称，链接程序就复制共享库文件的路径。

没有使用 -h 选项生成共享库时，运行时加载器仅查找库的文件名。可以将库替换为具有相同文件名的不同库。如果共享库有内部名称，加载器会在装入文件时检查内部名称。如果内部名称不匹配，加载器不会使用替换文件。

A.2.34.1 示例

example% CC -G -o libx.so.1 -h libx.so.1 a.o b.o c.o

A.2.35 –help

与 -xhelp=flags 相同。

A.2.36 -Ipathname

将 pathname 添加到 #include 文件中的搜索路径中。

该选项用于将 pathname 添加到在其中搜索具有相对文件名（不以斜杠开头的文件名）的 #include 文件的目录列表。

编译器按以下顺序搜索用引号引住的文件（形式为 #include "foo.h"）。

1. 在包含源代码的目录中

2. 在使用 -I 选项指定的目录（如果有）中

3. 在编译器提供的 C++ 头文件、ANSI C 头文件和专用文件的 include 目录中

4. 在 /usr/include 目录中

编译器按以下顺序搜索用尖括号括住的文件（形式为 #include <foo.h>）。

1. 在使用 -I 选项指定的目录（如果有）中

2. 在编译器提供的 C++ 头文件、ANSI C 头文件和专用文件的 include 目录中

3. 在 /usr/include 目录中

   ---

   注 –

   如果此拼写与标准头文件的名称匹配，另请参阅12.7.5 标准头文件实现。

   ---

A.2.36.1 交互

-I- 选项让您可以覆盖缺省的搜索规则。

如果指定了 -library=no%Cstd，那么编译器在其搜索路径中就不包括编译器提供的与 C++ 标准库关联的头文件。请参见12.7 替换 C++ 标准库。

如果未使用 –ptipath，编译器就会在 –Ipathname 中查找模板文件。

请使用 –Ipathname 而不是 –ptipath。

该选项会累积而不覆盖。

警告

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

另请参见

-I-

A.2.37 -I-

将头文件的搜索规则更改为：

对于形式为 #include "foo.h" 的 include 文件，按以下顺序搜索目录：

1. 使用 -I 选项指定的目录（在 -I- 前后）。

2. 编译器提供的 C++ 头文件、ANSI C 头文件和专用文件的目录。

3. /usr/include 目录。

对于 #include <foo.h> 形式的 include 文件，按以下顺序搜索目录：

1. 使用 -I 选项指定的目录（在 -I- 后面）。

2. 编译器提供的 C++ 头文件、ANSI C 头文件和专用文件的目录。

3. /usr/include 目录。

如果包括文件的名称与标准头的名称相匹配，另请参阅12.7.5 标准头文件实现。

A.2.37.1 示例

以下示例显示了编译 prog.cc 时使用 -I- 的结果。

prog.cc
#include "a.h"
#include <b.h>
#include "c.h"
c.h
#ifndef _C_H_1
#define _C_H_1
int c1;
#endif
inc/a.h
#ifndef _A_H
#define _A_H
#include "c.h"
int a;
#endif
inc/b.h
#ifndef _B_H
#define _B_H
#include <c.h>
int b;
#endif
inc/c.h
#ifndef _C_H_2
#define _C_H_2
int c2;
#endif

以下命令显示了针对形式为 #include "foo.h" 的包含语句搜索当前目录（包含文件的目录）的缺省行为。在 inc/a.h 中处理 #include "c.h" 语句时，编译器将 inc 子目录中的 c.h 头文件包含进来。在 prog.cc 中处理 #include "c.h" 语句时，编译器将包含 prog.cc 的目录中的 c.h 文件包含进来。请注意，-H 选项指示编译器打印所包含文件的路径。

example% CC -c -Iinc -H prog.cc
inc/a.h
        inc/c.h
inc/b.h
        inc/c.h
c.h

以下命令显示了 -I- 选项的效果。编译器处理形式为 #include "foo.h" 的语句时，并不先在包含目录中查找，而是按照通过 -I 选项指定的目录在命令行上的显示顺序搜索这些目录。在 inc/a.h 中处理 #include "c.h" 语句时，编译器包含 ./c.h 头文件而不是 inc/c.h 头文件。

example% CC -c -I. -I- -Iinc -H prog.cc
inc/a.h
        ./c.h
inc/b.h
        inc/c.h
./c.h

交互

命令行上有 -I- 时，编译器从不搜索当前目录，除非在 -I 指令中显式列出了该目录。甚至是形式为 #include "foo.h" 的包含语句，也是这种情况。

警告

只有命令行上的第一个 -I- 会导致出现所述行为。

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

A.2.38 –i

通知链接程序 ld 忽略任何 LD_LIBRARY_PATH 设置。

A.2.39 -include filename

此选项使编译器处理 filename 的方式就相当于其是位于主源文件首行的 #include 预处理程序指令。例如以下源文件 t.c：

main()
{
   ...
}

如果使用 cc -include t.h t.c 命令编译 t.c，如同源文件包含以下内容来编译：

#include "t.h"
main()
{
   ...
}

编译器搜索 filename 的第一个目录是当前的工作目录，不是包含主源文件的目录，这是显式包含文件时的情况。例如，以下目录结构包含两个具有相同名称但在不同位置的头文件：

foo/
   t.c
   t.h
   bar/
     u.c
     t.h

如果您的工作目录是 foo/bar 且使用 cc ../t.c -include t.h 命令进行编译，则编译器包括 foo/bar 中而不是 foo/ 中的 t.h，这是使用源文件 t.c 中的 #include 指令时的情况。

如果编译器在当前工作目录中找不到使用 -include 指定的文件，会在常规目录路径中搜索该文件。如果指定了多个 -include 选项，则按照文件在命令行中出现的顺序将其包含进来。

A.2.40 -inline

与 -xinline 相同。

A.2.41 –instances=a

控制模板实例的放置和链接。

A.2.41.1 值

a 必须是下列值之一。

缺省值

如果未指定 –instances，则假定 –instances=global。

另请参见

7.2.4 模板实例的放置和链接。

A.2.42 –instlib=filename

使用该选项可避免在库（共享或静态）和当前对象中生成重复的模板实例。一般来说，如果程序与库共享大量实例，可以尝试使用 -instlib=filename，看看编译时间是否会减少。

A.2.42.1 值：

可使用 filename 参数指定已知包含现有模块实例的库。filename 参数必须包含正斜杠 "/" 字符。对于相对于当前目录的路径，请使用点斜杠 "./"。

缺省：

-instlib=filename 选项没有缺省值，只有在指定后才能使用。该选项可被多次指定和累积。

示例：

假定 libfoo.a 和 libbar.so 库可对与源文件 a.cc 共享的大量模板实例进行实例化。添加 -instlib=filename 并指定库可通过避免冗余有利于减少编译时间。

example% CC -c -instlib=./libfoo.a -instlib=./libbar.so a.cc

交互：

使用 -g 进行编译时，如果使用 -instlib=file 指定的库没有使用 -g 编译，那么这些模板实例不可调试。解决方法是避免在使用 -g 时使用 -instlib=file。

警告

如果使用 -instlib 指定库，就必须与该库链接。

另请参见：

-template、-instances 和 -pti

A.2.43 –KPIC

SPARC： 与 –xcode=pic32 相同。

x86： 与 –Kpic 相同。

生成共享库时使用该选项编译源文件。对全局数据的每个引用都生成为全局偏移表中指针的非关联化。每个函数调用都通过过程链接表在 pc 相对地址模式中生成。

A.2.44 –Kpic

SPARC： 与 –xcode=pic13 相同。

x86： 使用与位置无关的代码进行编译。

生成共享库时使用该选项编译源文件。对全局数据的每个引用都生成为全局偏移表中指针的非关联化。每个函数调用都通过过程链接表在 pc 相对地址模式中生成。

A.2.45 –keeptmp

保留编译时创建的临时文件。

该选项与 –verbose=diags 一起使用，对调试很有用。

A.2.45.1 另请参见

–v, –verbose

A.2.46 –Lpath

将 path 添加到要在其中搜索库的目录列表。

该选项传递给 ld。搜索顺序是先搜索通过 path 指定的目录，再搜索编译器提供的目录。

A.2.46.1 交互

该选项会累积而不覆盖。

警告

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

A.2.47 –llib

将库 liblib.a 或 liblib.so 添加到链接程序的搜索库列表。

该选项传递给 ld。常规库的名称如 liblib.a 或 liblib.so，其中，lib 和 .a 或 .so 这些部分是必需的。应该使用此选项指定 lib 部分。应在一个命令行上输入尽可能多的库，对这些库搜索时按照使用 –Ldir 指定的顺序进行。

请在目标文件名之后使用该选项。

A.2.47.1 交互

该选项会累积而不覆盖。

较稳妥的方式是总是将 –lx 放在源文件和目标文件列表后面，这样可以确保按正确顺序搜索库。

警告

为了确保正确的库链接顺序，必须使用 -mt（而不是 -lthread）与 libthread 链接。

另请参见

–Ldir、-mt、11.4.8 示例应用程序和《Tools.h++ 类库参考》

A.2.48 –libmieee

与 –xlibmieee 相同。

A.2.49 –libmil

与 -xlibmil 相同。

A.2.50 -library=l[ ,l...]

将指定的 CC 提供的库加入编译和链接操作中。

A.2.50.1 值

对于兼容模式 (–compat[-4]])，l 必须是下列值之一。

在标准模式（缺省模式）下，l 必须是下列值之一：

缺省值

• 兼容模式 (–compat[=4])

  • 如果未指定 –library，则假定 -library=libC。

  • libC 库总是包括在内，除非使用 -library=no%libC 明确将其排除。

  标准模式（缺省模式）

  • libCstd 库总是包括在内，除非使用 -library=%none、-library=no%Cstd 或 -library=stlport4 明确将其排除。

  • libCrun 库总是包括在内，除非使用 -library=no%Crun 明确将其排除。

  无论是标准模式还是兼容模式，libm 库和 libc 库总是包括在内，即使指定了 -library=%none 也是如此。

示例

要在标准模式下没有任何 C++ 库（除 libCrun 之外）时进行链接，请使用：

example% CC -library=%none

要在标准模式下将传统 iostream Rogue tools.h++ 库包含进来，请使用：

example% CC –library=rwtools7,iostream

要在标准模式下将标准 iostream Rogue Wave tools.h++ 库包含进来，请使用：

example% CC -library=rwtools7_std

要在兼容模式下将传统 iostream Rogue Wave tools.h++ 库包含进来，请使用：

example% CC -compat -library=rwtools7

交互

如果使用 -library 指定了库，则在编译期间会设置适当的 –I 路径。在链接期间会设置适当的 –L、–Y P、–R 路径和 –l 选项。

该选项会累积而不覆盖。

在使用区间运算库时，必须包括以下库之一： libC、libCstd 或 libiostream。

使用 -library 选项可确保针对指定库的 -l 选项按正确顺序传送。例如，对于 -library=rwtools7,iostream 和 -library=iostream,rwtools7，-l 选项都是按照 -lrwtool -liostream 顺序传递给 ld。

指定的库在系统支持库链接之前链接。

不能在同一个命令行上使用 -library=sunperf 和 -xlic_lib=sunperf。

在任何命令行中，最多只能使用 -library=stlport4 或 -library=Cstd 选项之一。

每次只能使用一个 Rogue Wave 工具库，而且不能将任何 Rogue Wave 工具库与 -library=stlport4 一起使用。

在标准模式（缺省模式）下包含传统 iostream Rogue Wave 工具库时，必须也要包含 libiostream（有关其他信息，请参见《 C++ 迁移指南》。只能在标准模式下使用标准 iostream Rogue Wave 工具库。以下命令示例显示了有效使用和无效使用 Rogue Wave tools.h++ 库选项的情况。

% CC -compat -library=rwtools7 foo.cc        <-- valid
% CC -compat -library=rwtools7_std foo.cc    <-- invalid

% CC -library=rwtools7,iostream foo.cc       <-- valid, classic iostreams
% CC -library=rwtools7 foo.cc                <-- invalid

% CC -library=rwtools7_std foo.cc            <-- valid, standard iostreams
% CC -library=rwtools7_std,iostream foo.cc   <-- invalid

如果同时包含 libCstd 和 libiostream，必须小心，不要在程序中同时使用新旧格式的 iostream（例如，cout 和 std::cout）访问同一个文件。如果从传统和标准 iostream 代码访问同一文件，那么在相同的程序中混合标准 iostream 和传统 iostream 可能会出现问题。

不链接 libC 库的兼容模式程序无法使用 C++ 语言的所有功能。与之类似，不链接 Crun 或任何 Cstd 库或 stlport4 库的标准模式程序无法使用 C++ 语言的所有功能。

如果指定了 -xnolib，则忽略 -library。

警告

如果在不同的步骤中进行编译和链接，那么必须在链接命令中使用在编译命令中使用的那组 -library 选项。

stlport4、Cstd 和 iostream 库都提供了自己的 I/O 流实现。如果使用 -library 选项指定其中多个库，会导致出现不确定的程序行为。关于使用 STLport 实现的更多信息，请参阅 13.3 STLport。

库的集合不稳定，会因不同的发行版本而变化。

另请参见

–I、–l、–R、–staticlib、-xia、-xlang、–xnolib、11.4.8 示例应用程序、忠告：、13.3.1 重新分发和支持的 STLport 库、《Tools.h++ 用户指南》、《Tools.h++ 类库参考》、《Standard C++ Class Library Reference》和《C++ Interval Arithmetic Programming Reference》。

有关使用 -library=no%cstd 选项以便能够使用自己的 C++ 标准库的信息，请参见12.7 替换 C++ 标准库。

A.2.51 -m32|-m64

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

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

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

使用 -m32 编译的对象文件或库无法与使用 -m64 编译的对象文件或库链接。

使用 -m32|-m64 编译的模块还必须使用 -m32|-m64 进行链接。有关在编译时和链接时都必须指定的完整编译器选项列表，请参见3.3.3 编译时选项和链接时选项。

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

请注意，在早期的编译器发行版中，由 -xarch 选项中选择的指令集来指定内存模型（ILP32 或 LP64）。从 Sun Studio 12 编译器开始，就不再是这样了。在大多数平台上，仅需将 -m64 添加到命令行便可以创建 64 位对象。

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

另请参见 -xarch。

A.2.52 -mc

从目标文件的 .comment 部分中删除重复的字符串。如果字符串包含空格，就必须使用引号将该字符串括入。使用 -mc 选项时，会调用 mcs-c 命令。

A.2.53 –migration

解释了获取关于为编译器的早期版本生成的迁移源代码信息的位置。

在下一发行版本中该选项会取消。

A.2.54 –misalign

SPARC： 允许内存中包含未对齐数据，否则会生成错误。如以下代码所示：

char b[100];
int f(int * ar) {
return *(int *) (b +2) + *ar;
}

该选项通知编译器程序中的某些数据未正确对齐。因此，非常保守的装入和存储必须用于会不对齐的任何数据，即每次一个字节。使用该选项会显著降低运行时性能。性能降低的程度与应用程序有关。

A.2.54.1 交互

如果在 SPARC 平台上使用 #pragma pack 封装效果比类型的缺省对齐紧密，必须为应用程序的编译和链接指定 -misalign 选项。

未对齐数据由 ld 提供的陷阱机制在运行时处理。如果优化标志（-xO{1|2|3|4|5} 或等价的标志）与 -misalign 选项一起使用，则用于对齐未对齐数据的附加指令会插入生成的目标文件中，且不会生成运行时未对齐陷阱。

警告

如果可能，请不要链接程序的对齐部分和未对齐部分。

如果在不同的步骤中进行编译和链接，那么编译命令和链接命令中都必须有 –misalign 选项。

A.2.55 -mr[, string]

从目标文件的 .comment 部分中删除所有字符串，如果提供了 string，则将 string 放入该部分。如果字符串包含空格，就必须使用引号将该字符串括入。如果使用此选项，会调用命令 mcs -d [-a string]。

A.2.56 –mt

可使用此选项在使用 Solaris 线程或 POSIX 线程 API 时编译和链接多线程代码。-mt 选项可确保以适当的顺序链接库。

此选项将 -D_REENTRANT 传递给预处理程序。

要使用 Solaris 线程，应将 thread.h 头文件包含进来并使用 —mt 选项进行编译。要在 Solaris 平台上使用 POSIX 线程，应将 pthread.h 头文件包含进来并使用 —mt —lpthread 选项进行编译。

在 Linux 平台上，只有 POSIX 线程 API 可用。（在 Linux 平台上没有 libthread。）因此，Linux 平台上的 —mt 添加 —lpthread 而不是 —lthread。要在 Linux 平台上使用 POSIX 线程，应使用 —mt 进行编译。

请注意，使用 —G 进行编译时，—mt 不会自动包含 —lthread 和 —lpthread。需要在生成共享库时显式列出这些库。

—xopenmp 选项（用于使用 OpenMP 共享内存并行化 API）自动包含 —mt。

如果使用 -mt 进行编译并在单独的步骤中进行链接，则除了在编译步骤中外，还必须在链接步骤中使用 -mt 选项。如果使用 -mt 编译和链接一个转换单元，则必须使用 -mt 编译和链接该程序的所有单元。

A.2.56.1 另请参见

–xnolib、《Solaris 多线程编程指南》和《链接程序和库指南》

A.2.57 –native

与 –xtarget=native 相同。

A.2.58 –noex

与 –features=no%except 相同。

A.2.59 –nofstore

x86： 禁用表达式的强制精度。

该选项不将浮点表达式或函数的值强制为赋值左侧的类型，但会在以下任一条件为真时将值保留在寄存器中：

• 将表达式或函数分配到变量

  或

• 表达式或函数被强制转换为较短的浮点类型

A.2.59.1 另请参见

–fstore

A.2.60 –nolib

与 –xnolib 相同。

A.2.61 –nolibmil

与 –xnolibmil 相同。

A.2.62 –noqueue

（已过时）禁用许可证排队。

如果没有可用的许可证，该选项就会在无队列请求和编译的情况下返回。用于测试 makefile 的非零状态返回。该选项已过时并被忽略。

A.2.63 –norunpath

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

如果可执行文件使用共享库，编译器通常会生成将运行时链接程序指向这些共享库的路径。为此，编译器会将 –R 选项传递给 ld。路径取决于安装编译器的目录。

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

A.2.63.1 交互

如果使用编译器安装区域下的任何共享库，并且还使用 –norunpath，那么就应该在链接时使用 –R 选项或在运行时设置环境变量 LD_LIBRARY_PATH 来指定共享库的位置。该操作使运行时链接程序可以找到共享库。

A.2.64 –O

现在，-O 宏扩展到 -xO3 而不是 -xO2。

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

A.2.65 –Olevel

与 –xOlevel 相同。

A.2.66 –o filename

将输出文件或可执行文件的名称设置为 filename。

A.2.66.1 交互

编译器必须存储模板实例时，它将模板实例存储在输出文件目录中的模板系统信息库中。例如，以下命令将目标文件写入 ./sub/a.o 并将模板实例写入包含在 ./sub/SunWS_cache 中的系统信息库。

example% CC -instances=extern -o sub/a.o a.cc

编译器从对应于编译器读取的目标文件的模板系统信息库读取。例如，以下命令从 ./sub1/SunWS_Cache 和 ./sub2/SunWS_cache 读取，必要时，向 ./SunWS_cache 写入。

example% CC -instances=extern sub1/a.o sub2/b.o

有关更多信息，请参见7.4 模板系统信息库。

警告

filename 必须有与编译所生成文件的类型对应的适当后缀。它与源文件不是相同的文件，因此 CC 驱动程序不会覆盖源文件。

A.2.67 +p

忽略非标准预处理程序声明。

A.2.67.1 缺省值

如果没有 +p，则编译器识别非标准预处理程序声明。

交互

如果使用了 +p，就不定义下列宏：

• sun

• unix

• sparc

• i386

A.2.68 –P

仅预处理源代码，但不编译。（输出文件的后缀为 .i 。）

该选项不在输出中包括预处理程序类型的行号信息。

A.2.68.1 另请参见

–E

A.2.69 –p

已废弃，请参见A.2.165 –xpg。

A.2.70 –pentium

x86： 替换为 –xtarget=pentium。

A.2.71 –pg

与 –xpg 相同。

A.2.72 -PIC

SPARC： 与 –xcode=pic32 相同。

x86： 与 –Kpic 相同。

A.2.73 –pic

SPARC： 与 –xcode=pic13 相同。

x86： 与 -Kpic 相同。

A.2.74 –pta

与 –template=wholeclass 相同。

A.2.75 –ptipath

为模板源文件指定附加搜索目录。

该选项可替换 –Ipathname 设置的正常搜索路径。如果使用了 -ptipath 选项，编译器将在该路径上查找模板定义文件，并忽略 –Ipathname 选项。

如果使用 –Ipathname 选项而非 –ptipath，可以减少混淆情况。

A.2.75.1 交互

该选项会累积而不覆盖。

另请参见

–Ipathname 和7.5.2 定义搜索路径

A.2.76 –pto

与 –instances=static 相同。

A.2.77 –ptr

该选项已废弃并被编译器忽略。

A.2.77.1 警告

即使忽略 -ptr 选项，也应该从所有编译命令中删除 -ptr，因为在后续发行版中重用该选项时可能会产生不同的行为。

另请参见

有关系统信息库目录的信息，请参见7.4 模板系统信息库。

A.2.78 –ptv

与 –verbose=template 相同。

A.2.79 –Qoption phase option[,option…]

将 option 传递到编译阶段。

要传递多个选项，按照逗号分隔列表的顺序指定它们。可以对使用 -Q 传递给组件的选项进行重新排序。驱动程序识别的选项将按正确顺序排列。对于驱动程序已识别的选项，请勿使用 -Q。例如，C++ 编译器识别用于链接程序 (ld) 的 -z 选项。如果发出如下命令：

     CC -G -zallextract mylib.a -zdefaultextract ... // correct

则 -z 选项按顺序传递给链接程序。但是，如果指定了如下命令：

     CC -G -Qoption ld -zallextract mylib.a -Qoption ld -zdefaultextract ... // error

则会重新排序 -z 选项，从而得到错误的结果。

A.2.79.1 值

phase 必须是下列值之一。

示例

在下列命令行上，当 CC 驱动程序调用 ld 时，–Qoption 会将 –i 和 –m 选项传递给 ld。

example% CC -Qoption ld -i,-m test.c

警告

请注意避免无法预料的结果。例如，

-Qoption ccfe -features=bool,iddollar

被解释为

-Qoption ccfe -features=bool -Qoption ccfe iddollar

正确的用法为

-Qoption ccfe -features=bool,-features=iddollar

A.2.80 –qoption phase option

与 –Qoption 相同。

A.2.81 –qp

与 –p 相同。

A.2.82 –Qproduce sourcetype

使 CC 驱动程序生成类型为 sourcetype 的输出。

Sourcetype 后缀定义如下。

A.2.83 –qproduce sourcetype

与 –Qproduce 相同。

A.2.84 –Rpathname[:pathname…]

将动态库搜索路径生成到可执行文件中。

该选项传递给 ld。

A.2.84.1 缺省值

如果没有 -R 选项，则在输出对象中记录且传递给运行时链接程序的库搜索路径取决于 -xarch 选项（没有 -xarch 时，假定 -xarch=generic）指定的目标体系结构指令。

检查 —dryrun 的输出和传递给链接程序 ld 的 —R 选项，以查看编译器假定的缺省路径。

交互

该选项会累积而不覆盖。

如果定义了环境变量 LD_RUN_PATH 且指定了 –R 选项，则扫描 –R 指定的路径而忽略 LD_RUN_PATH 指定的路径。

另请参见

–norunpath 和《链接程序和库指南》。

A.2.85 –readme

与 -xhelp=readme 相同。

A.2.86 –S

编译并仅生成汇编代码。

该选项使 CC 驱动程序编译程序并输出汇编源文件，但不汇编程序。汇编源文件名称的后缀为 .s。

A.2.87 –s

从可执行文件中删除符号表。

该选项从输出可执行文件中删除所有符号信息。该选项传递给 ld。

A.2.88 –sb

已过时，默认忽略。

A.2.89 –sbfast

已过时，默认忽略。

A.2.90 -staticlib=l[ ,l…]

指示要静态链接由 -library 选项（包括其缺省值）、-xlang 选项和 -xia 选项指定的哪些 C++ 库。

A.2.90.1 值

l 必须是下列值之一。

缺省值

如果没有指定 –staticlib，则假定 –staticlib=%none。

示例

以下命令行静态链接 libCrun，因为 Crun 是 –library 的缺省值：

example% CC –staticlib=Crun (correct)

但以下命令行并不链接 libgc，因为只有使用 -library 选项显式指定才链接 libgc：

example% CC –staticlib=gc (incorrect)

要静态链接 libgc，请使用以下命令：

example% CC -library=gc -staticlib=gc (correct)

以下命令会动态链接 librwtool 库。因为 librwtool 不是缺省库且未使用 -library 选项选择它，因此 -staticlib 不起作用：

example% CC -lrwtool -library=iostream \
-staticlib=rwtools7 (incorrect)

该命令静态链接 librwtool 库：

example% CC -library=rwtools7,iostream -staticlib=rwtools7 (correct)

该命令将动态链接 Sun 性能库，因为 -library=sunperf 必须与 -staticlib=sunperf 结合使用，-staticlib 选项才能对这些库的链接有效：

example% CC -xlic_lib=sunperf -staticlib=sunperf (incorrect)
该命令将静态链接 Sun 性能库：

example% CC -library=sunperf -staticlib=sunperf (correct)

交互

该选项会累积而不覆盖。

除缺省情况下隐式选择的 C++ 库之外，-staticlib 选项仅对使用 -xia 选项、-xlang 选项和 -library 选项显式选择的 C++ 库有效。在兼容模式 (-compat=[4]) 下，缺省选择 libC。在标准模式（缺省模式）下，缺省选择 Cstd 和 Crun。

使用 -xarch=v9、-xarch=v9a 或 -xarch=v9b （或等价的 64 位体系结构选项）时，某些 C++ 库不能用作静态库。

警告

library 的允许值集合不确定，会随发行版的不同而异。

使用 -xarch=v9、-xarch=v9a 或 -xarch=v9b（或等价的 64 位体系结构选项）时，某些库不能用作静态库。

选项 -staticlib=Crun 和 -staticlib=Cstd 不能用于 64 位 Solaris x86 平台。Sun 建议不要在任何平台上静态链接这些库。在某些情况下，静态链接可能会使程序无法正常运行。

另请参见

-library 和12.5 静态链接标准库

A.2.91 -sync_stdio=[yes| no]

可在运行时性能因 C++ iostream 和 C stdio 之间的同步而降低时使用此选项。仅当您在相同的程序中使用 iostream 写入 cout 以及使用 stdio 写入 stdout 时，才需要同步。C++ 标准要求同步，因此缺省情况下 C++ 编译器打开同步。但是，不使用同步时，应用程序性能通常更佳。如果您的程序既不写入 cout 也不写入 stdout，则可以使用选项 -sync_stdio=no 关闭同步。

A.2.91.1 缺省：

如果未指定 -sync_stdio，编译器会将其设置为 -sync_stdio=yes。

示例：

请看以下示例：

#include <stdio.h>
#include <iostream>
int main()
{
   std::cout << "Hello ";
   printf("beautiful ");
   std::cout << "world!";
   printf("\n");
}

使用同步时，程序自行打印在一行中

Hello beautiful world!
:

不使用同步时，输出会变得杂乱。

警告：

此选项仅对链接可执行文件有效，对库无效。

A.2.92 –temp=path

为临时文件定义目录。

该选项设置目录的路径名称，用于存储在编译过程中生成的临时文件。对于 -temp 设置的值和 TMPDIR 值，编译器优先采用前者。

A.2.92.1 另请参见

–keeptmp

A.2.93 –template=opt[,opt…]

启用/禁用各种模板选项。

A.2.93.1 值

opt 必须是下列值之一。

缺省值

如果未指定 -template 选项，则假定 -template=no%wholeclass,extdef。

示例

请考虑以下代码：

example% cat Example.cc
     template <class T> struct S {
               void imf() {}
               static void smf() {}
     };

     template class S <int>;

     int main() {
     }
example%

指定了 -template=geninlinefuncs 时，即使在程序中没有调用 S 的两个成员函数，也会在目标文件中生成它们。

example% CC -c -template=geninlinefuncs Example.cc
example% nm -C Example.o

Example.o:

[Index] Value Size Type  Bind  Other Shndx Name
[5]       0   0    NOTY  GLOB  0     ABS   __fsr_init_value
[1]       0   0    FILE  LOCL  0     ABS   b.c
[4]      16   32   FUNC  GLOB  0     2     main
[3]     104   24   FUNC  LOCL  0     2     void S<int>::imf()
                                           [__1cBS4Ci_Dimf6M_v_]
[2]     64    20   FUNC  LOCL  0     2     void S<int>::smf()
                                           [__1cBS4Ci_Dsmf6F_v_]

另请参见

7.2.2 整个类实例化和7.5 模板定义搜索

A.2.94 –time

与 –xtime 相同。

A.2.95 –Uname

删除预处理程序符号 name 的初始定义。

该选项会删除在命令行上通过 -D（包括 CC 驱动程序隐式放在命令行上的选项）创建的宏符号 name 的所有初始定义。该选项对任何其他预定义的宏和源文件中的宏定义都没有影响。

要查看 CC 驱动程序放在命令行上的 -D 选项，请将 -dryrun 选项添加到命令行上。

A.2.95.1 示例

以下命令取消预定义符号 __sun 的定义。foo.cc 中的预处理程序语句（例如 #ifdef(__sun)）会知道该符号已取消定义。

example% CC -U__sun foo.cc

交互

可以在命令行上指定多个 -U 选项。

所有 -U 选项都在出现的任何 -D 选项之后处理。也就是说，如果在命令行上为 -D 和 -U 指定了相同的 name，则 name 是未定义的，而不管这些选项出现的顺序如何。

另请参见

-D

A.2.96 –unroll=n

与 –xunroll=n 相同。

A.2.97 –V

与 –verbose=version 相同。

A.2.98 –v

与 –verbose=diags 相同。

A.2.99 –vdelx

已过时，不使用。

仅限于兼容模式 (–compat[=4])：

对于使用 delete[] 的表达式，该选项生成对运行时库函数 _vector_deletex_ 的调用，而不是生成对 _vector_delete_ 的调用。函数 _vector_delete_ 使用两个参数： 要删除的指针以及每个数组元素的大小。

函数 _vector_deletex_ 的行为与 _vector_delete_ 的行为相同，但前者使用第三个参数： 类的析构函数的地址。第三个参数不用于该函数，而是供第三方供应商使用。

A.2.99.1 缺省

对于使用 delete[] 的表达式，编译器生成对 _vector_delete_ 的调用。

警告

这是在以后的发行版本中要删除的废弃选项。除非您已从第三方供应商购买了某些软件且供应商推荐使用该选项，否则请不要使用该选项。

A.2.100 –verbose=v[,v…]

控制编译器详细程度。

A.2.100.1 值

v 必须是下列值之一。

缺省值

如果未指定 –verbose，则假定 –verbose=%none。

交互

该选项会累积而不覆盖。

A.2.101 +w

识别出可能会产生意外后果的代码。使用 +w 选项时，如果函数过大而无法内联或未使用声明的程序元素，就不再生成警告。这些警告不指定源代码中的真正问题，因此不适合某些开发环境。从 +w 中删除这些警告就可以在这些环境下更主动地使用 +w。在 +w2 选项中仍可以使用这些警告。

该选项生成如下关于有问题构造的其他警告：

• 不可移植

• 可能出错

• 低效

A.2.101.1 缺省值

如果未指定 +w，则编译器发出有关极可能是问题的构造的警告。

另请参见

–w 和 +w2。

A.2.102 +w2

发出 +w 发出的所有警告以及可能无害但可能降低程序最大可移植性的技术违规的警告。

+w2 选项不再发出关于在系统头文件中使用与实现相关的构造方面的警告。因为系统头文件是实现，所以发出警告是不合适的。从 +w2 删除这些警告可以更主动地使用该选项。

A.2.102.1 另请参见

+w

A.2.103 –w

抑制大部分警告消息。

该选项使编译器不打印警告消息。但不能抑制某些警告（尤其是有关严重记时错误的警告）。

A.2.103.1 另请参见

+w

A.2.104 –Xm

与 –features=iddollar 相同。

A.2.105 –xa

为文件配置生成代码。

如果在编译时设置，则由环境变量 TCOVDIR 指定覆盖 (.d) 文件所在的目录。如果未设置该变量，则覆盖 (.d) 文件仍与 source 文件保存在同一目录中。

使用该选项是为了向后兼容旧的覆盖文件。

A.2.105.1 交互

-xprofile=tcov 选项和 -xa 选项在单个可执行程序中兼容。也就是说，在您链接的同一个程序中，既可包含用 –xprofile=tcov 编译的一些文件，也可包含用 –xa 编译的另外一些文件。您不能同时用这两个选项来编译同一个文件。

–xa 选项与 –g 不兼容。

警告

如果在不同的步骤中进行编译和链接，且使用 -xa 进行编译，应确保使用 –xa 进行链接，否则会产生意外的结果。

另请参见

–xprofile=tcov、tcov(1) 手册页和《程序性能分析工具》。

A.2.106 -xaddr32

（仅限 Solaris x86/x64）-xaddr32=yes 编译标志将生成的可执行文件或共享对象限定于 32 位地址空间。

以此方式编译的可执行文件导致创建的进程限定于 32 位地址空间。

指定 -xaddr32=no 时，会生成常见的 64 位二进制文件。

如果未指定 -xaddr32 选项，则假定 -xaddr32=no。

如果仅指定了 -xaddr32，则假定 -xaddr32=yes。

此选项仅适用于 -m64 编译，以及仅适用于支持 SF1_SUNW_ADDR32 软件功能的 Solaris 平台。由于 Linux 内核不支持地址空间限制，因此在 Linux 上此选项不可用。

链接时，如果使用 -xaddr32=yes 编译了单个目标文件，则假定使用 -xaddr32=yes 编译整个输出文件。

限定于 32 位地址空间的共享对象必须由受限的 32 位模式地址空间中执行的进程装入。

有关更多信息，请参阅《链接程序和库指南》中所述的“SF1_SUNW_ADDR32 软件功能定义”。

A.2.107 -xalias_level[= n]

(SPARC) 指定了以下命令时，C++ 编译器可以执行基于类型的别名分析和优化：

• -xalias_level[=n ]

  其中 n 是 any、simple 或 compatible。

• -xalias_level=any

  在此分析级别上，编译器假定任何类型都可以为其他类型起别名。不过尽管只是假定，但还是可以执行某些优化。

• -xalias_level=simple

  编译器假定简单的类型没有别名。具体来说就是具有动态类型的存储对象，这些类型是以下简单类型之一：

只能通过以下类型的左值访问：

• 对象的动态类型

  • 动态类型对象的 constant 或 volatile 限定版本，与动态类型对象对应的带符号或无符号类型

  • 与动态类型对象的 constant 或 volatile 限定版本对应的带符号或无符号类型

  • 在其成员（包括递归的子集成员或包含的联合）中包括上述类型的聚集或联合类型

  • char 或 unsigned char 类型

  -xalias_level=compatible

  编译器假定布局不兼容类型没有别名。存储对象只能通过以下类型的左值访问：

  • 对象的动态类型

  • 对象动态类型的 constant 或 volatile 限定版本，与对象动态类型相对应的带符号或不带符号的类型

  • 与动态类型对象的 constant 或 volatile 限定版本对应的带符号或无符号类型

  • 在其成员（包括递归的子集成员或包含的联合）中包括上述类型的聚集或联合类型

  • 动态类型对象的（可能是 constant 或 volatile 限定）基类类型

  • char 或 unsigned char type。

    编译器假定所有引用的类型都与相应存储对象的动态类型是布局兼容的。两种类型在以下情况下是布局兼容的：

  • 如果两个类型相同，则这两个类型就是布局兼容的类型。

  • 如果两个类型仅在 constant 或 volatile 限定中不同，则这两个函数是布局兼容的类型。

  • 每个存在的带符号整型对应（但是不相同）一个无符号整型。这些对应的类型是布局兼容的。

  • 如果两个枚举类型具有相同的基础类型，则它们是布局兼容的。

  • 如果两个简单旧数据 (Plain Old Data,POD) 结构类型具有相同数量的成员，并且对应的成员（按顺序）具有布局兼容的类型，那么这两个结构类型是布局兼容的。

  • 如果两个 POD 联合类型具有相同数量的成员，并且对应的成员（按顺序）具有布局兼容的类型，那么这两个联合类型是布局兼容的。

    在某些情况下具有存储对象动态类型的引用可能是非布局兼容的：

  • 如果 POD 联合包含了两个或两个以上共享通用初始序列的 POD 结构，且 POD 联合对象当前包含了其中一个 POD 结构，就可以检查任何 POD 结构的通用初始部分。对包含一个或多个初始成员的序列来说，如果相应成员具有布局兼容类型（适用于位字段）和相同宽度，则两个 POD 结构共享一个通用初始序列。

  • 指向 POD 结构对象的指针（使用 reinterpret_cast 适当转换）将指向该结构的初始成员，而如果该成员是位字段则指向该结构所在的单元。

A.2.107.1 缺省值

如果未指定 -xalias_level，则编译器将该选项设置为 -xalias_level=any。如果指定了 -xalias_level 但未提供值，则编译器将该选项设置为 -xalias_level=compatible。

交互

编译器在 -xO2 和更低的优化级别不执行基于类型的别名分析。

警告

如果要使用 reinterpret_cast 或等价的旧式强制类型转换，程序可能会违反分析假定。此外，联合类型也违反了分析的假定，如以下示例所示。

union bitbucket{
  int i;
  float f;
};

int bitsof(float f){
bitbucket var;
var.f=3.6;
return var.i;
}

A.2.108 - xannotate[=yes|no]

(Solaris) 指示编译器创建二进制文件，之后这些文件可以由 binopt(1) 之类的二进制文件修改工具进行转换。此外，将来的二进制文件分析、代码覆盖和内存错误检测工具也可以处理使用此选项生成的二进制文件。

使用 -xannotate=no 选项可阻止这些工具对二进制文件进行修改。

-xannotate=yes 选项必须与优化级别 -xO1 或更高级别一起使用才有效，且仅在具有新的链接程序支持库接口 -ld_open() 的系统上有效。如果在没有此链接程序接口的操作系统（如 Solaris 9 OS）上使用编译器，编译器会默认恢复为 -xannotate=no。Solaris 10 修补程序 127111-07、Solaris 10 Update 5 和 OpenSolaris 中提供了新的链接程序接口。

缺省值为 -xannotate=yes，但如果不符合以上任一条件，则缺省值恢复为 -xannotate=no。

此选项在 Linux 平台上不可用。

A.2.109 –xar

创建归档库。

生成使用模板的 C++ 归档文件时，必须将模板系统信息库中实例化的那些模板函数包括在该归档文件中。仅在使用 -instances=extern 选项编译了至少一个目标文件时才使用模板系统信息库。使用该选项可以将这些模板自动增加到所需的归档文件中。

A.2.109.1 值

对调用 ar -c -r 指定 -xar 并重新创建归档文件。

示例

以下命令行归档包含在库和目标文件中的模板函数。

example% CC -xar -o libmain.a a.o b.o c.o

警告

请勿在命令行上添加来自模板数据库中的 .o 文件。

请勿直接使用 ar 命令生成归档文件。应使用 CC–xar 以确保模板实例自动包括在归档文件中。

另请参见

ar(1) 和表 15–3

A.2.110 –xarch=isa

指定目标指令集体系结构 (instruction set architecture, ISA)。

该选项将编译器生成的代码限制为特定指令集体系结构的指令。此选项不保证使用任何特定于目标的指令。不过，使用该选项会影响二进制程序的可移植性。

分别使用 -m64 或 -m32 选项来指定打算使用的内存模型 LP64（64 位）或 ILP32（32 位）。-xarch 选项不再指示内存模型，除非是为了与早期的发行版兼容，如下所示。

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

A.2.110.1 用于 SPARC 的 -xarch 标志

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

另请注意：

• SPARC 指令集体系结构 V7、V8 和 V8a 已过时，不应使用。

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

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

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

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

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

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

A.2.110.2 用于 x86 的 -xarch 标志

下表列出了 x86 平台上的 -xarch 标志。

A.2.110.3 x86 特殊注意事项

针对 x86 Solaris 平台进行编译时，有一些重要问题值得注意。

传统的 Sun 样式的并行 pragma 在 x86 上不可用。而改用 OpenMP。有关将传统并行化指令转换为 OpenMP 的信息，请参见《Sun Studio OpenMP API 用户指南》。

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

在 Pentium 4 兼容的平台上 Solaris OS 发行版支持 SSE/SSE2。早期版本的 Solaris OS 不支持 SSE/SSE2。如果所运行的 Solaris OS 不支持由 -xarch 选定的指令集，则编译器无法为该指令集生成链接代码。

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

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

Solaris 和 Linux 之间的数值结果也可能不同，因为内部数学库（例如，sin(x)）并不相同。

A.2.110.4 二进制兼容验证

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

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

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

这一警告也扩展到使用 .il 内联汇编语言功能或使用 SSE、SSE2、SSE2a 和 SSE3 指令和扩展的 __asm() 汇编程序代码。

A.2.110.5 交互

尽管可以单独使用该选项，但它是 -xtarget 选项的扩展的一部分，并且可用于覆盖由特定的 -xtarget 选项设置的 -xarch 值。例如，-xtarget=ultra2 可扩展为 -xarch=v8plusa -xchip=ultra2 -xcache=16/32/1:512/64/1。在以下命令中， -xarch=v8plusb 覆盖了由 -xtarget=ultra2 的扩展设置的 -xarch=v8plusa。

example% CC -xtarget=ultra2 -xarch=v8plusb foo.cc

不支持 –compat[=4] 与 -xarch=generic64、-xarch=native64、-xarch=v9、-xarch=v9a 或 -xarch=v9b 结合使用。

A.2.110.6 警告

如果在进行优化时使用该选项，那么在指定体系结构上适当选择就可以提供高性能的可执行文件。但如果选择不当就会导致性能的严重降级，或导致在预定目标平台上无法执行二进制程序。

如果在不同的步骤中编译和链接，请确保在两个步骤中为 -xarch 指定了相同的值。

A.2.111 -xautopar

此选项不接受 OpenMP 并行化指令。Sun 特定的 MP pragma 已过时，并且不再受支持。有关标准的指令的迁移信息，请参见《Sun Studio OpenMP API 用户指南》。

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

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

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

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

如果使用 -xautopar 且在一个步骤中进行编译和链接，则链接会自动将微任务化库和线程安全的 C 运行时库包含进来。如果使用 -xautopar 并在不同的步骤中进行编译和链接，则还必须使用 -xautopar 进行链接。

A.2.111.1 另请参见

A.2.158 -xopenmp[= i]

A.2.112 -xbinopt={prepare| off}

(SPARC) 指示 编译器准备二进制文件，以便以后进行优化、转换和分析，请参见 binopt(1)。此选项可用于生成可执行文件或共享对象。如果在不同的步骤中进行编译，则在编译步骤和链接步骤中都必须有 -xbinopt：

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

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

A.2.112.1 缺省值

缺省值为 -xbinopt=off。

交互

此选项必须与 -xO1 或更高的优化级别一起使用时才有效。使用此选项生成二进制文件时，文件大小会有所增加。

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

A.2.113 -xbuiltin[={ %all|%none}]

启用或禁用对标准库调用进行优化改进。

缺省情况下，编译器会将标准库头文件中声明的函数视为普通函数。但编译器会将其中一些函数识别为“内部函数”或“内置函数”。视为内置函数时，编译器可以生成更有效的代码。例如，编译器可以识别无副作用的函数，且通常为给定的相同输入返回相同的输出。编译器可将部分函数直接生成为内联函数。有关如何读取目标文件中的编译器注解来确定编译器实际对哪些函数进行替换的说明，请参见 er_src(1) 手册页。

-xbuiltin=%all 选项表示要求编译器识别尽可能多的内置标准函数。所识别函数的确切列表在不同的编译器代码生成器版本中各不相同。

-xbuiltin=%none 选项表示采用缺省编译器行为，编译器对内置函数不进行任何特殊优化。

A.2.113.1 缺省值

如果未指定 -xbuiltin 选项，则编译器假定 -xbuiltin=%none。

如果仅指定了 -xbuiltin，则编译器假定 -xbuiltin=%all。

交互

宏 -fast 的扩展包括了 -xbuiltin=%all。

示例

下面的编译器命令请求标准库调用的特殊处理。

example% CC -xbuiltin -c foo.cc

下面的编译器命令请求不对标准库调用进行特别处理。请注意，宏 -fast 的扩展包括了 -xbuiltin=%all。

example% CC -fast -xbuiltin=%none -c foo.cc

A.2.114 –xcache=c

定义要由优化器使用的高速缓存属性。此选项不保证使用每个特定的缓存属性。

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

此发行版引入一个可选属性 [/ti]，该属性用来设置可以共享缓存的线程数。

A.2.114.1 值

c 必须是下列值之一。

高速缓存属性 si/li/ai/ti 的定义如下：

例如，i=1 指定 1 级高速缓存属性 s1/l1/a1。

缺省值

如果未指定 –xcache，则假定为缺省值 –xcache=generic。该值指示了编译器在多数 SPARC 处理器上使用缓存属性来获得高性能，而不降低任何处理器的性能。

如果没有为 t 指定值，则缺省值为 1。

示例

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

另请参见

–xtarget=t

A.2.115 -xcg[89|92]

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

A.2.116 -xchar[= o]

提供此选项只是为了方便从 char 类型定义为 unsigned 的系统中迁移代码。如果不是从这样的系统中迁移，最好不要使用该选项。只有那些依赖字符类型符号的程序才需要重写，它们要改写成显式指定带符号或者无符号。

A.2.116.1 值

o 可以是下列值之一：

缺省值

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

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

交互

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

警告

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

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

A.2.117 -xcheck[= i]

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

A.2.117.1 值

i 必须是下列值之一：

缺省值

如果未指定 -xcheck，则编译器缺省使用 -xcheck=%none。

如果指定了没有任何参数的 -xcheck，则编译器缺省使用 -xcheck=%none。

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

A.2.118 -xchip=c

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

–xchip 选项通过指定目标处理器来指定定时属性。该选项会影响：

• 指令的顺序（即调度）

• 编译器使用分支的方法

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

  ---

  注 –

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

  ---

A.2.118.1 值

c 必须是下列值之一。

缺省值

在大多数处理器中，generic 为缺省值，即指示编译器使用最佳定时属性以获得高性能，而不会显著降低任何处理器的性能。

A.2.119 –xcode=a

SPARC： 指定代码地址空间。

应通过指定 -xcode=pic13 或 -xcode=pic32 生成共享对象。未使用 pic13 或 pic32 生成的共享对象不能正常工作，也可能根本无法生成。

A.2.119.1 值

a 必须是下列值之一。

要确定是使用 –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。

缺省值

对于 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，应使用 nm 确定库中使用或定义的不同全局变量和静态变量的数量。如果 _GLOBAL_OFFSET_TABLE_ 的大小小于 8,192 字节，就可以使用 -Kpic。否则，就必须使用 -xcode=pic32。

A.2.120 -xcrossfile[= n]

已废弃，不使用。改用 -xipo。

A.2.121 -xdebugformat=[stabs|dwarf]

编译器将调试器信息格式从 stabs 格式迁移为“DWARF 调试信息格式”中指定的 dwarf 格式。在此发行版中，缺省设置为 -xdebugformat=stabs。

如果要维护读取调试信息的软件，您现在可以选择将工具从 stabs 格式转换为 dwarf 格式。

出于移植工具的目的，可以通过此选项来使用新的格式。除非您要维护读取调试器信息的软件，或者特定工具要求使用这些格式之一的调试器信息，否则不需要使用此选项。

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

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

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

这是过渡性接口，因此会在发行版之间发生更改而不兼容，即使在发行版更新较少时也是如此。stabs 或 dwarf 格式的任何特定字段或值的详细资料也在不断改进。

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

A.2.122 -xdepend=[yes| no]

(SPARC) 对循环进行迭代间数据依赖性分析，并执行循环重构，包括循环交换、循环合并、标量替换和“死数组”赋值消除。

在 SPARC 上，对于所有优化级别 -xO3 以及更高级别，-xdepend 缺省为 —xdepend=on。否则，—xdepend 缺省为 —xdepend=off。指定 -xdepend 的显式设置会覆盖任何缺省设置。

在 x86 上，—xdepend 缺省为 —xdepend=off。指定 —xdepend 且优化级别不是 —xO3 或更高级别时，编译器会将优化级别提高到 —xO3 并发出警告。

指定不带参数的 -xdepend 等效于 —xdepend=yes。

-xautopar 中包含了依赖性分析。依赖性分析会在编译时进行。

依赖性分析在单处理器系统中可能很有用。但是，如果在单处理器系统上使用 -xdepend，不应该同时指定 -xautopar，因为将针对多处理器系统进行 -xdepend 优化。

另请参见：-xprefetch_auto_type

A.2.123 -xdumpmacros[= value[,value...]]

要查看宏在程序中的行为方式时使用此选项。该选项提供了诸如宏定义、取消定义的宏和宏用法实例的信息，并按宏的处理顺序将输出打印到标准错误 (stderr)。-xdumpmacros 选项在整个文件中或在 dumpmacros 或 end_dumpmacros pragma 覆盖它之前都是有效的。请参见B.2.5 #pragma dumpmacro s。

A.2.123.1 值

value 可以是下列参数：

这些选项值会累积，因此指定 -xdumpmacros=sys -xdumpmacros=undefs 与指定 -xdumpmacros=undefs,sys 效果相同。

子选项 loc、conds 和 sys 是 defs、undefs 和 use 选项的限定符。使用 loc、conds 和 sys 本身并不会生成任何结果。例如，使用 -xdumpmacros=loc,conds,sys 不会生成什么结果。

缺省值

如果指定了没有任何参数的 -xdumpmacros，则表示 -xdumpmacros=defs,undefs,sys。如果未指定 -xdumpmacros，则缺省为 -xdumpmacros=%none。

示例

如果使用选项 -xdumpmacros=use,no%loc，则使用的每个宏名称只打印一次。但是，如果要了解更多详细信息，请使用选项 -xdumpmacros=use,loc，这样每次使用宏时都会打印位置和宏名称。

例如以下文件 t.c：

example% cat t.c
#ifdef FOO
#undef FOO
#define COMPUTE(a, b) a+b
#else
#define COMPUTE(a,b) a-b
#endif
int n = COMPUTE(5,2);
int j = COMPUTE(7,1);
#if COMPUTE(8,3) + NN + MM
int k = 0;
#endif

以下示例显示了使用 defs、undefs、sys 和 loc 参数时文件 t.c 的输出。

example% CC -c -xdumpmacros -DFOO t.c
#define __SunOS_5_9 1
#define __SUNPRO_CC 0x590
#define unix 1
#define sun 1
#define sparc 1
#define __sparc 1
#define __unix 1
#define __sun 1
#define __BUILTIN_VA_ARG_INCR 1
#define __SVR4 1
#define __SUNPRO_CC_COMPAT 5
#define __SUN_PREFETCH 1
#define FOO 1
#undef FOO
#define COMPUTE(a, b) a + b

example% CC -c -xdumpmacros=defs,undefs,loc -DFOO -UBAR t.c
command line: #define __SunOS_5_9 1
command line: #define __SUNPRO_CC 0x590
command line: #define unix 1
command line: #define sun 1
command line: #define sparc 1
command line: #define __sparc 1
command line: #define __unix 1
command line: #define __sun 1
command line: #define __BUILTIN_VA_ARG_INCR 1
command line: #define __SVR4 1
command line: #define __SUNPRO_CC_COMPAT 5
command line: #define __SUN_PREFETCH 1
command line: #define FOO 1
command line: #undef BAR
t.c, line 2: #undef FOO
t.c, line 3: #define COMPUTE(a, b) a + b

以下示例说明了 use、loc 和 conds 参数如何报告文件 t.c 中宏的行为：

example% CC -c -xdumpmacros=use t.c
used macro COMPUTE

example% CC -c -xdumpmacros=use,loc t.c
t.c, line 7: used macro COMPUTE
t.c, line 8: used macro COMPUTE

example% CC -c -xdumpmacros=use,conds t.c
used macro FOO
used macro COMPUTE
used macro NN
used macro MM

example% CC -c -xdumpmacros=use,conds,loc t.c
t.c, line 1: used macro FOO
t.c, line 7: used macro COMPUTE
t.c, line 8: used macro COMPUTE
t.c, line 9: used macro COMPUTE
t.c, line 9: used macro NN
t.c, line 9: used macro MM

例如文件 y.c：

example% cat y.c
#define X 1
#define Y X
#define Z Y
int a = Z;

以下是使用 -xdumpmacros=use,loc 时有关 y.c 中宏的输出：

example% CC -c -xdumpmacros=use,loc y.c
y.c, line 4: used macro Z
y.c, line 4: used macro Y
y.c, line 4: used macro X

另请参见

要覆盖 -xdumpmacros 的作用域时，请使用 dumpmacros pragma 和 end_dumpmacros pragma。

A.2.124 -xe

仅检查语法和语义错误。指定 -xe 时，编译器不生成任何目标代码。 -xe 的输出定向到 stderr。

如果不需要通过编译生成目标文件，可使用 -xe 选项。例如，如果要尝试通过删除代码段找出导致出现错误消息的原因，可使用 -xe 加速编辑和编译周期。

A.2.124.1 另请参见

–c

A.2.125 -xF[=v[,v...]]

启用通过链接程序对函数和变量进行最佳重新排列。

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

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

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

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

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

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

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

2. 按照《程序性能分析工具》手册中有关如何生成用于函数的映射文件的说明进行操作，或按照《链接程序和库指南》中有关如何生成用于数据的映射文件的说明进行操作。

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

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

A.2.125.1 值

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

缺省值

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

交互

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

另请参见

analyzer(1)、debugger(1) 和 ld(1) 手册页

A.2.126 -xhelp=flags

显示了对每个编译器选项的简要描述。

A.2.127 -xhelp=readme

显示联机 readme 文件的内容。

readme 文件按环境变量 PAGER 中指定的命令分页。如果未设置 PAGER，则缺省的分页命令为 more。

A.2.128 -xhwcprof

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

如果启用了 -xhwcprof，编译器将生成信息，这些信息可帮助工具将文件配置的加载和存储指令与其所引用的数据类型和结构成员相关联（与由 -g 生成的符号信息一起）。它将配置文件数据同目标文件的数据空间（而不是指令空间）相关联，并对行为进行洞察，而这仅从指令配置中是无法轻易获得的。

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

如果分别在单独的步骤中进行编译和链接，最好在链接时使用 -xhwcprof。如果将来扩展为 -xhwcprof，则在链接时可能需要使用它。

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

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

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

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

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

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

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

A.2.129 -xia

链接适当的区间运算库，并设置适当的浮点环境。

C++ 区间运算库与 Fortran 编译器中实现的区间运算相兼容。

在 x86 平台上，需要支持 SSE2 指令集。

A.2.129.1 扩展

-xia 选项是一个扩展到 -fsimple=0 -ftrap=%none -fns=no -library=interval 的宏。如果使用区间并通过为 -fsimple、-ftrap、-fns 或 -library 指定不同的标志来覆盖 -xia 设置的内容，则可能会导致编译器出现不正确的行为。

交互

要使用区间运算库，请将 <suninterval.h> 包含进来。

在使用区间运算库时，必须包括以下库之一： libC、Cstd 或 iostream。有关包括这些库的信息，请参见 -library。

警告

如果您使用区间并为 -fsimple、-ftrap 或 -fns 指定了不同的值，则您的程序可能有不正确的行为。

C++ 区间运算处于实验阶段且正在改进。不同的发行版本具有不同的功能。

另请参见

-library

A.2.130 -xinline[=func_spec[,func_spec...]]

指定在 -xO3 或更高的优化级别优化器可以内联用户编写的哪些例程。

A.2.130.1 值

func_spec 必须是下列值之一。

只有使用了 -xipo[=1|2] 时，才会内联要编译的文件中的例程。优化器决定适合内联的例程。

缺省值

如果未指定 -xinline 选项，则编译器假定 -xinline=%auto。

如果指定了没有任何参数的 -xinline=，则不内联函数，而不管优化级别是什么。

示例

要启用自动内联同时禁用内联声明为 int foo() 的函数，请使用

example% CC -xO5 -xinline=%auto,no%__1cDfoo6F_i_ -c a.cc

要强烈要求内联声明为 int foo() 的函数，并使所有其他函数作为要内联的候选函数，请使用

example% CC -xO5 -xinline=%auto,__1cDfoo6F_i_ -c a.cc

要强烈要求内联声明为 int foo() 的函数，且不允许内联任何其他函数，请使用

example% CC -xO5 -xinline=__1cDfoo6F_i_ -c a.cc

交互

优化级别低于 -xO3 时，-xinline 选项不起作用。在 -xO4 或更高的优化级别上，优化器会决定应该内联哪些函数，无需指定 -xinline 选项即可完成。另外，在 -xO4 或更高的优化级别上，编译器会尝试确定内联哪些函数可以提高性能。

如果出现以下任一情况，则会内联例程。

• 优化级别为 -xO3 或更高

• 认为内联有益且安全

• 函数在要编译的文件中，或函数在使用 -xipo[=1|2] 编译了的文件中

警告

如果使用 -xinline 强制内联函数，实际上可能会降低性能。

另请参见

A.2.136 -xldscope={v}

A.2.131 -xinstrument=[ no%]datarace

指定此选项编译您的程序并为其提供程序设备，以供线程分析器进行分析。有关线程分析器的更多详细信息，请参见 tha(1)。

然后可使用性能分析器以 collect -r races 来运行此检测的程序，从而创建数据竞争检测实验。可以单独运行已提供了程序设备的代码，但其运行速度将非常缓慢。

可指定 -xinstrument=no%datarace 来关闭线程分析器的源代码准备。这是缺省值。

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

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

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

该选项也设置 -g。

A.2.132 -xipo[={0|1|2}]

执行过程间优化。

-xipo 选项通过调用过程间分析传递来执行部分程序优化。它会在链接步骤中对所有目标文件执行优化，且优化不限于只是编译命令中的那些源文件。但是，使用 -xipo 执行的整个程序优化不包括汇编 (.s) 源文件。

编译和链接大型多文件应用程序时，-xipo 选项特别有用。用该标志编译的对象目标文件具有在这些文件内编译的分析信息，这些信息实现了在源代码和预编译的程序文件中的过程间分析。但分析和优化只限于使用 -xipo 编译的目标文件，并不扩展到目标文件或库。

A.2.132.1 值

-xipo 选项可以是下列值。

缺省值

如果未指定 -xipo，则假定 -xipo=0。

如果仅指定了 -xipo，则假定 -xipo=1。

示例

以下示例在相同的步骤中编译和链接。

example% CC -xipo -xO4 -o prog  part1.cc part2.cc part3.cc

优化器在三个源文件之间执行交叉文件内联。这在链接的最后一步完成，因此不必在一次编译所有源文件，可以分多次单独进行编译，每次编译时都指定 -xipo 选项。

以下示例在不同的步骤中编译和链接。

example% CC -xipo -xO4 -c part1.cc part2.cc
example% CC -xipo -xO4 -c part3.cc
example% CC -xipo -xO4 -o prog part1.o part2.o part3.o

在编译步骤中创建的目标文件具有在文件内部编译的附加分析信息，这样就可以在链接步骤中执行跨文件优化。

交互

-xipo 选项要求优化级别至少为 -xO4。

不能在同一编译器命令行上同时使用 -xipo 选项和 -xcrossfile 选项。

警告

在不同的步骤中进行编译和链接时，必须在这两个步骤中都指定 -xipo 才有效。

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

即使使用 -xipo 对库进行了编译，这些库也不参与交叉文件的过程间分析，如以下示例中所示。

example% CC -xipo -xO4 one.cc two.cc three.cc
example% CC -xar -o mylib.a one.o two.o three.o
...
example% CC -xipo -xO4 -o myprog main.cc four.cc mylib.a

本示例中，在 one.cc、two.cc 和 three.cc 之间以及 main.cc 和 four.cc 之间执行过程间优化，但不在 main.cc 或 four.cc 和 mylib.a 中的例程之间执行过程间优化。（第一个编译可能生成有关未定义符号的警告，但仍可执行过程间优化，因为过程间优化是编译和链接的一个步骤。）

由于执行跨文件优化时需要附加信息，因此 -xipo 选项会生成更大的目标文件。不过，该附加信息不会成为最终的二进制可执行文件的一部分。可执行程序大小的增加都是由于执行的附加优化导致的。

A.2.132.2 何时不使用 -xipo 过程间分析

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

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

• 目标文件集合中的任何例程调用 foo() 时，不会插入该目标文件集合之外定义的不同版本的 foo()。

如果假定 1 对于给定的应用程序不成立，请勿使用 -xipo=2 进行编译。

如果假定 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() 中，从而导致出现错误的结果。

另请参见

-xjobs

A.2.133 -xipo_archive=[a]

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

a 是以下项之一：

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

指定不带标志的 -xipo_archive 是非法的。

A.2.134 -xjobs=n

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

A.2.134.1 值

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

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

缺省值

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

示例

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

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

A.2.135 -xlang=language[,language]

包含适当的运行时库，并确保指定语言的适当运行时环境。

A.2.135.1 值

language 必须是 f77、f90、f95 或 c99。

f90 和 f95 参数等价。c99 参数表示为已使用 -xc99=%all 编译并要使用 CC 链接的对象调用 ISO 9899:1999 C 编程语言行为。

交互

-xlang=f90 和 -xlang=f95 选项隐含了-library=f90，而 -xlang=f77 选项隐含了 -library=f77。但要进行混合语言链接，只使用 -library=f77 和 -library=f90 选项是不够的，因为只有 -xlang 选项才能确保适当的运行时环境。

要决定在混合语言链接中使用的驱动程序，请使用下列语言分层结构：

1. C++

2. Fortran 95（或 Fortran 90）

3. Fortran 77

4. C 或 C99

将 Fortran 95、Fortran 77 和 C++ 目标文件链接在一起时，请使用最高级语言的驱动程序。例如，使用下列 C++ 编译器命令来链接 C++ 和 Fortran 95 目标文件。

example% CC -xlang=f95...

要链接 Fortran 95 和 Fortran 77 目标文件，请使用如下所示的 Fortran 95 驱动程序。

example% f95 -xlang=f77...

不能在同一编译器命令中同时使用 -xlang 选项和 -xlic_lib 选项。如果要使用 -xlang 且需要在 Sun 性能库中进行链接，应改用 -library=sunperf。

警告

请勿将 -xnolib 与 -xlang 一起使用。

如果要将并行的 Fortran 对象与 C++ 对象混合，链接行必须指定 -mt 标志。

另请参见

-library 和 -staticlib

A.2.136 -xldscope={v}

可指定 -xldscope 选项来更改外部符号定义的缺省链接程序作用域。由于更好的隐藏了实现，所以对缺省的更改会产生更快速更安全的共享库和可执行文件。

A.2.136.1 值

v 必须是下列值之一：

缺省值

如果未指定 -xldscope，编译器将假定 -xldscope=global。如果指定了没有任何值的 -xldscope，则编译器就会发出错误。出现最合适的实例之前，该选项的多重实例在命令行上会互相覆盖。

警告

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

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

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

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

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

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

另请参见

-xinline、-xO 和 -xcrossfile。

A.2.137 -xlibmieee

使 libm 在异常情况下对于数学例程返回 IEEE 754 值。

libm 的缺省行为是兼容 XPG。

A.2.137.1 另请参见

《数值计算指南》

A.2.138 -xlibmil

内联选定的 libm 库例程以进行优化。

该选项不影响 C++ 内联函数。

有一些可用于部分 libm 库例程的内联模板。该选项为当前使用的浮点选项和平台选择这些内联模板，生成执行速度最快的可执行文件。

A.2.138.1 交互

–fast 选项隐含了该选项。

另请参见

-fast 和《数值计算指南》。

A.2.139 –xlibmopt

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

此选项使用经过了性能优化的数学例程库，通常情况下，生成的代码运行速度较快。这样生成的代码可能与普通数学库生成的代码稍有不同，不同之处通常在最后一位上。

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

A.2.139.1 交互

–fast 选项隐含了该选项。

另请参见

–fast、–xnolibmopt 和 -fround

A.2.140 –xlic_lib=sunperf

已过时，不使用。改为指定 -library=sunperf。有关更多信息，请参见A.2.50 -library=l[ ,l...]。

A.2.141 –xlicinfo

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

A.2.142 -xlinkopt[= level]

指示编译器在对目标文件进行优化的基础上对生成的可执行文件或动态库执行链接时优化。这些优化在链接时通过分析二进制目标代码来执行。虽然未重写目标文件，但生成的可执行代码可能与初始目标代码不同。

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

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

A.2.142.1 值

level 设置执行的优化级别，必须为 0、1 或 2。优化级别如下：

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

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

注意，仅当链接编译器时才使用级别参数。在以上示例中，即使编译二进制目标文件时使用的是隐含的级别 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

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

警告

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

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

A.2.143 -xloopinfo

此选项用于显示并行化的循环和没有并行化的循环。它通常与 -xautopar 选项结合使用。

A.2.144 –xM

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

但是，-xM 只报告包含的头文件的依赖性，而不报告关联的模板定义文件的依赖性。可以使用 makefile 中的 .KEEP_STATE 功能在 make 实用程序创建的 .make.state 文件中生成所有依赖性。

A.2.144.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

交互

如果指定 -xM 和 -xMF，编译器会将所有 makefile 依赖性信息写入使用 -xMF 指定的文件。每次预处理程序向此文件写入时即将其覆写。

另请参见

make(1S)（了解有关 makefile 和依赖性的详细信息）。

A.2.145 -xM1

生成与 –xM 类似的 makefile 依赖性，只是它不报告 /usr/include 头文件的依赖性，也不报告编译器提供的头文件的依赖性。

如果指定 -xM1 和 -xMF，编译器会将所有 makefile 依赖性信息写入使用 -xMF 指定的文件。每次预处理程序向此文件写入时即将其覆写。

A.2.146 -xMD

生成与 -xM 类似的 makefile 依赖性，但包括编译。-xMD 基于输入文件名但添加 .d 后缀生成 makefile 依赖性信息的输出文件。如果指定 -xMD 和 -xMF，预处理程序会将所有 makefile 依赖性信息附加到使用 -xMF 指定的文件。

A.2.147 -xMF

此选项用于指定 makefile 依赖性输出的文件。目前，没有方法可以在命令行上使用 -xMF 为多个输入文件指定单独的文件名。

A.2.148 -xMMD

此选项用于生成不包含系统头文件的 makefile 依赖性。它与 -xM1 的功能相同，只是还包括编译。-xMMD 基于输入文件名但添加 .d 后缀生成 makefile 依赖性信息的输出文件。如果同时指定了 -xMMD 和 -xMF，编译器将改用提供的文件名。

A.2.149 –xMerge

SPARC： 将数据段和文本段合并。

目标文件中的数据是只读数据，并在进程之间共享，除非使用 ld-N 进行链接。

-xMerge -ztext -xprofile=collect 这三个选项不应该一起使用。-xMerge 强制将静态初始化的数据写入只读存储，而 -ztext 禁止只读存储中有与位置有关的符号重定位，-xprofile=collect 在可写存储中生成静态初始化的、与位置有关的符号重定位。

A.2.149.1 另请参见

ld(1) 手册页。

A.2.150 -xmaxopt[=v]

此命令将 pragma opt 的级别限制为指定的级别。v 可以为 off、1、2、3、4 或 5。缺省值为 -xmaxopt=off ，表示忽略 pragma opt。如果指定 -xmaxopt 但未提供参数，相当于指定 - xmaxopt=5。

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

A.2.151 -xmemalign=ab

(SPARC) 使用 -xmemalign 选项控制编译器对数据对齐所做的假定。通过控制可能会出现非对齐内存访问的代码和出现非对齐内存访问时的处理程序，可以更轻松的将程序移植到 SPARC。

指定最大假定内存对齐和非对齐数据访问的行为。必须有一个同时用于 a（对齐）和 b（行为）的值。a 指定最大假定内存对齐，b 指定未对齐内存访问行为。

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

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

如果运行时的实际数据对齐小于指定的对齐，则未对齐的访问尝试（内存读取或写入）生成一个陷阱。对陷阱的两种可能响应是

• 操作系统将陷阱转换为 SIGBUS 信号。如果程序无法捕捉到信号，则程序终止。即使程序捕捉到信号，未对齐的访问尝试仍将无法成功。

• 操作系统通过翻译未对齐的访问并将控制返回给程序（仿佛访问已成功正常结束）来处理陷阱。

A.2.151.1 值

下表列出了 -xmemalign 的对齐值和行为值。

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

缺省值

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

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

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

在有 -xmemalign 选项但未提供值时，缺省值为：

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

示例

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

A.2.152 -xmodel=[a]

(x86) -xmodel 选项使编译器可以针对 Solaris x86 平台修改 64 位对象形式，只应在要编译此类对象时指定该选项。

仅当启用了 64 位的 x64 处理器上还指定了 -m64 时，该选项才有效。

a 必须是以下值之一：